Netdata
What it does
Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.
- Connects 在云端运行
- Account or key Needs Authorization
- Category 开发者工具
安装
选择你使用的 AI 应用,然后复制设置。
通过 3/5 项检查 · 你的提问会经过开发者的服务器(app.netdata.cloud) · ✓ 命令已检查 2026年11月13日
第一步:你用哪个 AI?
选择你用的应用,步骤会显示在下方。
可连接 Claude · 约 5 分钟
需要 Netdata 的密钥(在开发者网站创建) · 在 claude.ai 或桌面应用设置一次,即可在聊天中使用 · 免费账户可添加 1 个 · Team/Enterprise 方案由所有者(Owner)添加
打开 Claude 的 Connectors 页面
CustomizeConnectors
点击“Add” → “Custom” → “Web”,填写这 2 项
把这里的内容复制到 Claude 中同名的输入框,然后点击 Continue
Name · 名称NetdataRemote MCP server URL · 地址https://app.netdata.cloud/api/v1/mcp在 Request headers 下添加这个名称和值
Header 名称Authorization值Bearer <在这里粘贴你的密钥>只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
在 Claude 检测到的登录设置页点击 Continue · Authentication 按作者说明选择(Sign in now、Sign in when needed 或 No sign in),然后点击 Add
在聊天中开启
+ConnectorsNetdata
试一试
用 Netdata 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude 说正在使用 Netdata,或回答中出现 Netdata 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
ChatGPT 暂时无法连接 Netdata
Netdata 连接时需要你自己的密钥,但 OpenAI 帮助页面只说明了 OAuth 登录,没有我们能核实的填密钥方式
你可以改用这些方式
A · 使用能连接 Netdata 的应用
- 需要 Netdata 的密钥(在开发者网站创建) · 在 claude.ai 或桌面应用设置一次,即可在聊天中使用 · 免费账户可添加 1 个 · Team/Enterprise 方案由所有者(Owner)添加
- 需要 Netdata 的密钥(在开发者网站创建)
- 需要 Netdata 的密钥(在开发者网站创建)
- 需要 Netdata 的密钥(在开发者网站创建)
B · 开发者工具 类中能连接 ChatGPT 的其他服务器
从同类中使用较多的里挑选,仅限用地址即可连接、无需密钥的
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
可连接 Claude Code · 约 5 分钟
需要 Netdata 的密钥(在开发者网站创建)
打开终端
Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell
粘贴这条命令并按 Enter
claude mcp add --transport http --scope user netdata https://app.netdata.cloud/api/v1/mcp --header 'Authorization: Bearer {NETDATA_CLOUD_API_TOKEN}'按 Enter 前,把“your-value”改成你的密钥
只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
在 Claude Code 中输入 /mcp
应能看到 Netdata 在列表中并显示已连接
试一试
用 Netdata 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude Code 说正在使用 Netdata,或回答中出现 Netdata 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Cursor · 约 5 分钟
需要 Netdata 的密钥(在开发者网站创建)
填写你的密钥
在 Netdata 的设置中,Authorization 还是空的,填入你的密钥并保存
只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
在 Cursor 中以 Agent 模式打开 AI 聊天
试一试
用 Netdata 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Cursor 说正在使用 Netdata,或回答中出现 Netdata 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同
可连接 VS Code · 约 5 分钟
需要 Netdata 的密钥(在开发者网站创建)
填写你的密钥
在 Netdata 的设置中,Authorization 还是空的,填入你的密钥并保存
只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
在 VS Code 中以 Agent 模式打开 AI 聊天
试一试
用 Netdata 告诉我你能帮我做什么,然后做一件给我看✓ 如果 VS Code 说正在使用 Netdata,或回答中出现 Netdata 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同
开发者专用:终端命令和 JSON 设置
通过网页连接
Claude Code
claude mcp add --transport http --scope user netdata https://app.netdata.cloud/api/v1/mcp --header 'Authorization: Bearer {NETDATA_CLOUD_API_TOKEN}'Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"netdata": {
"url": "https://app.netdata.cloud/api/v1/mcp",
"headers": {
"Authorization": "Bearer {NETDATA_CLOUD_API_TOKEN}"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"netdata": {
"type": "http",
"url": "https://app.netdata.cloud/api/v1/mcp",
"headers": {
"Authorization": "Bearer {NETDATA_CLOUD_API_TOKEN}"
}
}
}
}需要你填写的值
- 具有 scope:mcp 范围的 Netdata Cloud API 令牌
查看英文原文
Netdata Cloud API token with scope:mcp
说明为自动翻译,变量名保持原样;不确定时请查看原文。
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
一览
哪些应用可以使用它
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
通过互联网连接,适用于
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
它能做什么
服务器要求先登录,才会列出它的工具。
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月14日
- ✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 netdata 验证,该账户拥有此仓库
- ✓ 通过
仍在维护
代码最后更新于今天
- ✓ 通过
有许可证
使用 GPL-3.0
- ! 注意
端点有响应
拒绝访问(HTTP 401),且未提供 OAuth 登录。可能需要密钥,也可能是拦截机器人,尚未确认。
- ! 注意
使用 OAuth 登录
需要你自己复制粘贴密钥或令牌
- … 尚未检查
工具描述中没有隐藏指令
尚未检查;我们会在检查端点时读取工具列表
讨论
提问、分享技巧或报告无法使用。按“有帮助”数量排序。
用户评价
还没有评价
与“开发者工具”中的其他服务器比较i
- 星标数多于此分类中其他 5887 个服务器的 99%
- 发布到注册中心的时间比此分类中其他 5887 个服务器的 70% 更新
- 基础检查结果等于或优于此分类中其他 5887 个服务器的 10%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
Netdata 安全吗?
它在 5 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
你需要填写:Authorization
它在我的电脑上运行还是在云端?
它在作者的云端运行。通过互联网连接,无需安装,但你发送的内容会经过作者的服务器。
它还在维护吗?
GitHub 仓库最后更新于今天,最新版本(2.12.3)于10天前进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,因此也能用于接受远程 MCP 的应用,例如网页版 ChatGPT(Business 及以上为完整 MCP;Pro 为只读)。
同类别的其他选择
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
GitHub
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Serena MCP: the IDE for your agent
A powerful toolkit for coding, providing semantic retrieval and editing capabilities.
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
Netdata MCP
All Netdata Agents and Parents (v2.6.0+) are Model Context Protocol (MCP) servers, enabling AI assistants to interact with your infrastructure monitoring data.
Every Netdata Agent and Parent includes an MCP server, listening at same port the dashboard is listening at (default: 19999).
Netdata provides comprehensive access to all available observability data through MCP, including complete metadata:
- Node Discovery - Hardware specifications, operating system details, version information, streaming topology, and associated metadata
- Metrics Discovery - Full-text search capabilities across contexts, instances, dimensions, and labels
- Function Discovery - Access to system functions including
processes,network-connections,streaming,systemd-journal,windows-events, etc. - Alert Discovery - Real-time visibility into active and raised alerts
- Metrics Queries - Complex aggregations and groupings with ML-powered anomaly detection
- Metrics Scoring - Root cause analysis leveraging anomaly detection and metric correlations
- Alert History - Complete alert transition logs and state changes
- Function Execution - Execute Netdata functions on any connected node (requires Netdata Parent)
- Log Exploration - Access logs from any connected node (requires Netdata Parent)
For sensitive features currently protected by Netdata Cloud SSO, a temporary MCP API key is generated on each Netdata instance. When presented via the Authorization: Bearer header, this key unlocks access to sensitive data and protected functions (like systemd-journal, windows-events and processes). This temporary API key mechanism will eventually be replaced with a new authentication system integrated with Netdata Cloud.
AI assistants have different visibility depending on where they connect:
- Netdata Cloud: (coming soon) Full visibility across all nodes in your infrastructure
- Netdata Parent Node: Visibility across all child nodes connected to that parent
- Netdata Child/Standalone Node: Visibility only into that specific node
Transport Options
Netdata implements the MCP protocol with multiple transport options:
| Transport | Endpoint | Use Case | Version Requirement |
|---|---|---|---|
| WebSocket | ws://YOUR_IP:19999/mcp | Original transport, requires nd-mcp bridge for stdio clients | v2.6.0+ |
| HTTP Streamable | http://YOUR_IP:19999/mcp | Direct connection from AI clients supporting HTTP | v2.7.2+ |
| SSE | http://YOUR_IP:19999/sse | Server-Sent Events for real-time streaming | v2.7.2+ |
- Direct Connection (v2.7.2+): AI clients that support HTTP or SSE transports can connect directly to Netdata
- Bridge Required: AI clients that only support stdio need the
nd-mcp(stdio-to-websocket) ormcp-remote(stdio-to-http or stdio-to-sse) bridge
Official MCP Remote Client (mcp-remote)
If your AI client doesn't support HTTP/SSE directly and you don't want to use nd-mcp, you can use the official MCP remote client (requires Netdata v2.7.2+):
# Export your MCP key once per shell
export NETDATA_MCP_API_KEY="$(cat /var/lib/netdata/mcp_dev_preview_api_key)"
For HTTP transport
npx mcp-remote@latest --http http://YOUR_NETDATA_IP:19999/mcp \ --allow-http \ --header "Authorization: Bearer $NETDATA_MCP_API_KEY"
For SSE transport
npx mcp-remote@latest --sse http://YOUR_NETDATA_IP:19999/mcp \ --allow-http \ --header "Authorization: Bearer $NETDATA_MCP_API_KEY"
Note: The --allow-http flag is required for non-HTTPS connections. Only use this on trusted networks as traffic will not be encrypted.
Finding the nd-mcp Bridge
Note: With the new HTTP and SSE transports, many AI clients can now connect directly to Netdata without nd-mcp. Check your AI client's documentation to see if it supports direct HTTP or SSE connections.
The nd-mcp bridge is only needed for AI clients that:
- Only support
stdiocommunication (like some desktop applications) - Cannot use HTTP or SSE transports directly
- Cannot use
npx mcp-remote@latest
The nd-mcp bridge needs to be available on your desktop or laptop where your AI client runs. Since most users run Netdata on remote servers rather than their local machines, you have two options:
- If you have Netdata installed locally - Use the existing nd-mcp
- If Netdata is only on remote servers - Build nd-mcp on your desktop/laptop
Option 1: Using Existing nd-mcp
If you have Netdata installed on your desktop/laptop, find the existing bridge:
Linux
# Try these locations in order:
which nd-mcp ls -la /usr/sbin/nd-mcp ls -la /usr/bin/nd-mcp ls -la /opt/netdata/usr/bin/nd-mcp ls -la /usr/local/bin/nd-mcp ls -la /usr/local/netdata/usr/bin/nd-mcp
Or search for it:
find / -name "nd-mcp" 2>/dev/null
Common locations:
- Native packages (apt, yum, etc.):
/usr/sbin/nd-mcpor/usr/bin/nd-mcp - Static installations:
/opt/netdata/usr/bin/nd-mcp - Built from source:
/usr/local/netdata/usr/bin/nd-mcp
macOS
# Try these locations:
which nd-mcp ls -la /usr/local/bin/nd-mcp ls -la /usr/local/netdata/usr/bin/nd-mcp ls -la /opt/homebrew/bin/nd-mcp
Or search for it:
find / -name "nd-mcp" 2>/dev/null
Windows
# Check common locations:
dir "C:\Program Files\Netdata\usr\bin\nd-mcp.exe" dir "C:\Netdata\usr\bin\nd-mcp.exe"
Or search for it:
where nd-mcp.exe
Option 2: Building nd-mcp for Your Desktop
If you don't have Netdata installed loca you can build just the nd-mcp bridge. Netdata provides three implementations - choose the one that best fits your environment:
- Go bridge (recommended) - Go bridge source code
- Produces a single binary with no dependencies
- Creates executable named
nd-mcp(nd-mcp.exeon windows) - Includes both
build.shandbuild.bat(for Windows)
- Node.js bridge - Node.js bridge source code
- Good if you already have Node.js installed
- Creates script named
nd-mcp.js - Includes
build.sh
- Python bridge - Python bridge source code
- Good if you already have Python installed
- Creates script named
nd-mcp.py - Includes
build.sh
To build:
# Clone the Netdata repository
git clone https://github.com/netdata/netdata.git cd netdata
Choose your preferred implementation
cd src/web/mcp/bridges/stdio-golang/ # or stdio-nodejs/ or stdio-python/
Build the bridge
./build.sh # On Windows with the Go version, use build.bat
The executable will be created with different names:
- Go: nd-mcp
- Node.js: nd-mcp.js
- Python: nd-mcp.py
Test the bridge with your Netdata instance (replace localhost with your Netdata IP)
./nd-mcp ws://localhost:19999/mcp # Go bridge ./nd-mcp.js ws://localhost:19999/mcp # Node.js bridge ./nd-mcp.py ws://localhost:19999/mcp # Python bridge
You should see:
nd-mcp: Connecting to ws://localhost:19999/mcp...
nd-mcp: Connected
Press Ctrl+C to stop the test
Get the absolute path for your AI client configuration
pwd # Shows current directory
Example output: /home/user/netdata/src/web/mcp/bridges/stdio-golang
Your nd-mcp path would be: /home/user/netdata/src/web/mcp/bridges/stdio-golang/nd-mcp
Important: When configuring your AI client, use the full absolute path to the executable:
- Go bridge:
/path/to/bridges/stdio-golang/nd-mcp - Node.js bridge:
/path/to/bridges/stdio-nodejs/nd-mcp.js - Python bridge:
/path/to/bridges/stdio-python/nd-mcp.py
Verify the Bridge Works
Once you have nd-mcp (either from existing installation or built), test it:
# Test connection to your Netdata instance (replace YOUR_NETDATA_IP with actual IP)
/path/to/nd-mcp ws://YOUR_NETDATA_IP:19999/mcp
You should see:
nd-mcp: Connecting to ws://YOUR_NETDATA_IP:19999/mcp...
nd-mcp: Connected
Press Ctrl+C to stop the test
Using MCP Remote Client
The official MCP remote client (mcp-remote) is an alternative bridge that enables stdio-only AI clients to connect to Netdata's HTTP and SSE transports (requires Netdata v2.7.2+). Unlike nd-mcp which only supports WebSocket, mcp-remote provides broader transport compatibility.
When to Use MCP Remote
Use mcp-remote when:
- Your AI client only supports stdio communication
- You want to use HTTP or SSE transports instead of WebSocket
- You're running Netdata v2.7.2 or later
- You don't want to build/install nd-mcp
Installation
No installation required - mcp-remote runs via npx:
# Test the connection
npx mcp-remote@latest --http http://YOUR_NETDATA_IP:19999/mcp \ --allow-http \ --header "Authorization: Bearer YOUR_API_KEY"
Transport Options
mcp-remote supports multiple transport strategies:
# HTTP transport (recommended)
npx mcp-remote@latest --http http://YOUR_NETDATA_IP:19999/mcp \ --allow-http \ --header "Authorization: Bearer YOUR_API_KEY"
SSE transport
npx mcp-remote@latest --sse http://YOUR_NETDATA_IP:19999/mcp \ --allow-http \ --header "Authorization: Bearer YOUR_API_KEY"
Auto-detect with fallback (tries SSE first, falls back to HTTP)
npx mcp-remote@latest --transport sse-first http://YOUR_NETDATA_IP:19999/mcp \ --allow-http \ --header "Authorization: Bearer YOUR_API_KEY"
HTTPS (no --allow-http flag needed)
npx mcp-remote@latest --http https://YOUR_NETDATA_IP:19999/mcp \ --header "Authorization: Bearer YOUR_API_KEY"
Common Options
| Option | Description | Example |
|---|---|---|
--http | Use HTTP transport | --http http://host:19999/mcp |
--sse | Use SSE transport | --sse http://host:19999/mcp |
--allow-http | Allow non-HTTPS connections (required for HTTP URLs) | --allow-http |
--header | Add custom headers (for authentication) | --header "Authorization: Bearer KEY" |
--transport | Transport strategy | --transport sse-first (tries SSE, falls back to HTTP) |
--debug | Enable debug logging | --debug |
--host | OAuth callback host (default: localhost) | --host 127.0.0.1 |
| Port number | OAuth callback port (optional) | 9696 |
Authentication
For Netdata MCP, pass the API key via the Authorization header:
# Using environment variable (recommended)
export NETDATA_MCP_API_KEY="$(cat /var/lib/netdata/mcp_dev_preview_api_key)"
npx mcp-remote@latest --http http://YOUR_NETDATA_IP:19999/mcp \ --allow-http \ --header "Authorization: Bearer $NETDATA_MCP_API_KEY"
Security Note: The --allow-http flag is required for non-HTTPS connections. Only use this on trusted networks as traffic will not be encrypted.
Troubleshooting
Connection Issues:
# Enable debug logging
npx mcp-remote@latest --debug --http http