Back to Browse

mcp-grafana MCP Server

by dockndevai
Data & AnalyticsLow Risk8.2Local
Free

Search & edit Grafana dashboards, query datasources (PromQL/LogQL/SQL), inspect alerts.

About

A safe-by-default MCP server for Grafana. Search dashboards and folders, read the dashboard JSON model, list and query datasources (Prometheus/Loki/SQL via Grafana's unified /api/ds/query), and inspect alert rules and annotations. In higher modes it can create/update dashboards and folders, write annotations, and delete. Safe by default: starts read-only with only the 11 read tools registered — edits need read-write, deletes need admin plus GRAFANA_ALLOW_DELETE. Access modes, folder allowlist + protected folders, datasource allowlist, dry-run and a JSON audit log are enforced by a pure policy engine on top of the service-account token's role; datasource secrets are always redacted. Ships a bundled skill capturing the dashboard JSON model and query conventions so agents build to a consistent standard.

Security Report

8.2
Low Risk8.2Low Risk

This is a well-engineered MCP server with a strong security-first design. Authentication is properly enforced via Grafana service account tokens, capabilities are gated by configurable access modes, and sensitive data (datasource secrets) is systematically redacted. The code is clean, well-tested, and implements defense-in-depth with folder allowlists, protected folders, datasource filtering, and comprehensive audit logging. Minor code quality observations exist but do not materially affect security. Package verification found 1 issue.

7 files analyzed · 5 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "mcp-grafana": {
      "args": [
        "-y",
        "@dockndevai/mcp-grafana"
      ],
      "command": "npx"
    }
  }
}

Getting Started

Once installed, try these example prompts and explore these capabilities:

  • 1Ask: "Show request rate and p95 latency for the API" — runs PromQL via query_datasource
  • 2Tool: search — find a dashboard's UID
  • 3Tool: get_dashboard — read the JSON model to edit
  • 4Tool: create_or_update_dashboard — save a versioned dashboard to a folder

Reviews

No reviews yet

Be the first to review this server!