Grafana-MCP

An MCP (Model Context Protocol) server that gives Bob direct access to your Grafana instance — dashboards, datasources, queries, alerting rules, and more.

Prerequisites

• Node.js v18 or later

• A running Grafana instance

• A Grafana user with sufficient permissions (Admin recommended for full access)

Related MCP server: Grafana MCP Server

Installation

Install dependencies and build

git clone <url>
cd grafana-mcp
npm install
npm run build

The compiled server is now at build/index.js.

Configuration

The server reads three required environment variables and one optional one:

Registering with Bob

There are two places you can register the server. Most users will prefer the global config so the server is available in every Bob workspace without any per-project setup.

Option A — Global config (recommended)

Edit ~/.bob/settings/mcp.json (Windows: %USERPROFILE%\.bob\settings\mcp.json) and add the server entry. Replace the path with the absolute path to the built entry point on your machine:

{
  "mcpServers": {
    "grafana-mcp": {
      "command": "node",
      "args": ["C:\\absolute\\path\\to\\grafana-mcp\\build\\index.js"],
      "env": {
        "GRAFANA_URL": "http://your-grafana-host:3000",
        "GRAFANA_USER": "admin",
        "GRAFANA_PASSWORD": "your-password",
        "SOCKS_PROXY": "socks5://<proxy-host>:<port>"
      }
    }
  }
}

SOCKS_PROXY is optional — omit it if you don't need a proxy.

Option B — Project/workspace config

Add the same entry to .bob/mcp.json at the root of a specific workspace. This scopes the server to that project only.

{
  "mcpServers": {
    "grafana-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/grafana-mcp/build/index.js"],
      "env": {
        "GRAFANA_URL": "http://your-grafana-host:3000",
        "GRAFANA_USER": "admin",
        "GRAFANA_PASSWORD": "your-password",
        "SOCKS_PROXY": "socks5://<proxy-host>:<port>"
      }
    }
  }
}

SOCKS_PROXY is optional — omit it if you don't need a proxy.

To point at a different Grafana instance, change GRAFANA_URL (and credentials as needed) in whichever config file you used.

Available Tools

Troubleshooting

If MCP server shows "disconnected" in Bob IDE

The system node binary requires a version of c-ares that might not be installed on the machine. Try using the node binary bundled with Bob IDE instead — it has everything it needs built in.

Find it:

find ~/.bobide-server/bin -name "node" -type f

Then update command in your MCP config:

"command": "/root/.bobide-server/bin/<hash>/node"