selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
mcp-grafana logo

Self-host mcp-grafana

v2.1.1

MCP server for Grafana observability and management

ReleaseOpen SourceApache-2.0
Updated12 hours ago
LanguageGo
Setup difficultyModerate
Stars
3 621
Ports
8000 (SSE and streamable-http transport listener), 8080 (healthz endpoint (optional separate listener)), 9090 (Prometheus metrics endpoint (optional separate listener)), 8443 (HTTPS streamable-http transport (example))
Requires
Grafana
Docker
grafana/mcp-grafana
Install with Docker

What is mcp-grafana?

mcp-grafana is a Model Context Protocol (MCP) server that gives AI assistants structured access to a Grafana instance and its ecosystem. It exposes over 100 tools organized into categories including dashboards (search, create, update, patch, render), datasources (list, create, health checks), Prometheus/Loki/Tempo/InfluxDB/SQL/CloudWatch/Elasticsearch/Graphite/Quickwit querying, alerting rules and routing, Grafana OnCall schedules and alert groups, Incident management, annotations, snapshots, provisioning validation, and Agent Observability for LLM conversation analysis. Tools are opt-in via --enabled-tools flags. The server runs in stdio (default), SSE, or streamable-http transports. It requires Grafana 9.0+ and authenticates via service account tokens. Deployment options include Docker (grafana/mcp-grafana), standalone binary, uvx, Helm chart, or building from Go source. Read-only and query-free modes restrict write or query operations for safer deployments.

Should you self-host mcp-grafana?

mcp-grafana scores 65/100 on selfhost.directory (how scoring works) and ranks #24 of 166 in Developer Tools. It has 3 621 GitHub stars.

It shipped 9 stable releases in the past year. The latest, v2.1.1, came out on 20 October 2026. New versions land roughly every 1 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is openhands (87/100, 92 094 stars). It scores higher overall, so compare the two before you pick. See mcp-grafana vs openhands side by side.

Features

  • Alerting management
  • CloudWatch queryingDisabled by default; enable with --enabled-tools=cloudwatch
  • Dashboard management
  • Datasource management
  • Elasticsearch/OpenSearch queryingDisabled by default; enable with --enabled-tools=elasticsearch
  • Google Cloud Logging queryingDisabled by default; enable with --enabled-tools=cloudlogging; requires Google Cloud Logging datasource plugin 1.8.0+ and Grafana 11.2+
  • Graphite queryingDisabled by default; enable with --enabled-tools=graphite
  • Incident Management
  • InfluxDB queryingDisabled by default; enable with --enabled-tools=influxdb
  • Loki querying
  • Prometheus querying
  • Quickwit queryingDisabled by default; enable with --enabled-tools=quickwit
  • SQL datasource queryingDisabled by default; enable with --enabled-tools=sql
  • Tempo tracing

mcp-grafana README

How to install mcp-grafana

Install mcp-grafana with Docker

Docker Engine
Environment variables
GRAFANA_URL, GRAFANA_SERVICE_ACCOUNT_TOKEN, MCP_GRAFANA_SERVER_TOKEN, GRAFANA_ORG_ID, GRAFANA_USERNAME, GRAFANA_PASSWORD, GRAFANA_EXTRA_HEADERS, GRAFANA_SOCKS5_PROXY, GRAFANA_FORWARD_HEADERS

docker pull grafana/mcp-grafana

For local Grafana (STDIO mode):

docker run --rm -i -e GRAFANA_URL=http://localhost:3000 -e GRAFANA_SERVICE_ACCOUNT_TOKEN= grafana/mcp-grafana -t stdio

For Grafana Cloud (STDIO mode):

docker run --rm -i -e GRAFANA_URL=https://myinstance.grafana.net -e GRAFANA_SERVICE_ACCOUNT_TOKEN= grafana/mcp-grafana -t stdio

SSE mode:

docker run --rm -p 8000:8000 -e GRAFANA_URL=http://localhost:3000 -e GRAFANA_SERVICE_ACCOUNT_TOKEN= -e MCP_GRAFANA_SERVER_TOKEN= grafana/mcp-grafana

Streamable HTTP mode:

docker run --rm -p 8000:8000 -e GRAFANA_URL=http://localhost:3000 -e GRAFANA_SERVICE_ACCOUNT_TOKEN= -e MCP_GRAFANA_SERVER_TOKEN= grafana/mcp-grafana -t streamable-http

Default entrypoint runs SSE mode; must override with -t stdio for STDIO mode. Use -i flag to keep stdin open.

mcp-grafana releases & version history

More in API

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…