Grafana

grafana-mcp

Servidor MCP para Grafana — gerencie dashboards, datasources, regras de alerta, pastas e anotações via stdio.

Instalação

bunx @daanrongen/grafana-mcp

Ferramentas (17 no total)

Domínio	Ferramentas	Cobertura
Dashboards	list_dashboards, get_dashboard, create_dashboard, update_dashboard, delete_dashboard	Ciclo de vida completo do dashboard
Datasources	list_datasources, get_datasource, create_datasource, delete_datasource	Gerenciamento de datasources
Alertas	list_alert_rules, get_alert_rule, list_alert_instances	Regras de alerta e instâncias Alertmanager em disparo
Pastas	list_folders, create_folder, delete_folder	Organização de pastas
Anotações	list_annotations, create_annotation	Anotações de dashboard e globais
Saúde	health_check	Status da instância Grafana

Configuração

Variável	Obrigatória	Descrição
GRAFANA_URL	Sim	URL base do Grafana (ex.: http://localhost:3000)
GRAFANA_API_KEY	Sim	Token da conta de serviço ou chave de API do Grafana

Configuração

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "grafana": {
      "type": "stdio",
      "command": "bunx",
      "args": ["@daanrongen/grafana-mcp"],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_API_KEY": "your-service-account-token"
      }
    }
  }
}

Claude Code CLI

claude mcp add grafana \
  -e GRAFANA_URL=http://localhost:3000 \
  -e GRAFANA_API_KEY=your-service-account-token \
  -- bunx @daanrongen/grafana-mcp

Desenvolvimento

bun install
bun run dev        # run with --watch
bun test           # run test suite
bun run typecheck  # type-check with tsc
bun run lint       # biome lint
bun run format     # biome format
bun run build      # bundle to dist/main.js

Inspeção local

Use o MCP Inspector para navegar e chamar ferramentas interativamente contra uma instância real do Grafana:

GRAFANA_URL=http://localhost:3000 \
GRAFANA_API_KEY=your-service-account-token \
bun run inspect

Isso abre a interface do MCP Inspector no navegador, apontando para o servidor compilado localmente.

Arquitetura

src/
├── config.ts                   # Effect Config — GRAFANA_URL, GRAFANA_API_KEY
├── main.ts                     # Entry point — ManagedRuntime + StdioServerTransport
├── domain/
│   ├── GrafanaClient.ts        # Context.Tag service interface (port)
│   ├── errors.ts               # GrafanaError, NotFoundError
│   ├── models.ts               # Schema.Class models (Dashboard, Datasource, AlertRule, …)
│   ├── dashboards.test.ts      # Domain tests using GrafanaClientTest
│   ├── datasources.test.ts     # Domain tests using GrafanaClientTest
│   └── health.test.ts          # Domain tests using GrafanaClientTest
├── infra/
│   ├── GrafanaClientLive.ts    # Layer using fetch against the Grafana HTTP API
│   └── GrafanaClientTest.ts    # In-memory Ref-based test adapter
└── mcp/
    ├── server.ts               # McpServer wired to ManagedRuntime
    ├── utils.ts                # formatSuccess, formatError
    └── tools/                  # dashboards.ts, datasources.ts, alerts.ts, folders.ts, annotations.ts, health.ts

Licença

MIT