Netdata
Created 6 months ago
Netdata provides a Model Context Protocol (MCP) server for AI assistants to interact with infrastructure monitoring data.
What is Netdata?
Discovery, exploration, reporting and root cause analysis using all observability data, including metrics, logs, systems, containers, processes, and network connections
Documentation
Netdata Model Context Protocol (MCP) Integration# Overview
The AI assistants have different visibility on your infrastructure, depending on where in a Netdata hierarchy they are connected:
- Netdata Cloud: (not yet available) AI assistants connected to Netdata Cloud will have full visibility across all nodes in your infrastructure.
- Netdata Parent Node: AI assistants connected to a Netdata parent node will have visibility across all child nodes connected to that parent.
- Netdata Child Node: AI assistants connected to a Netdata child node will only have visibility into that specific node.
- Netdata Standalone Node: AI assistants connected to a standalone Netdata node will only have visibility into that specific node.
Supported AI Assistants
You can use Netdata with the following AI assistants:
- Claude Desktop: supports flat-fee usage for unlimited access
- Claude Code: supports flat-fee usage for unlimited access
- Cursor: supports flat-fee usage for unlimited access. Enables Netdata use with multiple AI assistants, including Claude, ChatGPT, and Gemini.
Installation
The MCP server is built into Netdata and requires no additional installation. Just ensure you have a recent version of Netdata installed.
Configuration of AI Assistants
The configuration of most AI assistants is done via a configuration file, which is almost identical for all of them.
{
"mcpServers": {
"netdata": {
"command": "/usr/bin/nd-mcp",
"args": [
"ws://IP_OF_YOUR_NETDATA:19999/mcp?api_key=YOUR_API_KEY"
]
}
}
}
The program nd-mcp is the bridge program that converts stdio communication to WebSocket communication. This program is part of all Netdata installations, so by installing Netdata on your personal computer (Linux, MacOS, Windows) you will have it available.
Server Config
{
"mcpServers": {
"netdata-server": {
"command": "npx",
"args": [
"netdata"
]
}
}
}