Grafana MCP Server

Что умеет сервер

Grafana MCP Server выпускает Grafana Labs (репозиторий grafana/mcp-grafana). Он открывает AI-агенту экземпляр Grafana и окружающие сервисы: поиск, чтение, создание и точечное изменение дашбордов, получение запросов и источников данных каждой панели, запросы к источникам Prometheus (PromQL) и Loki (LogQL), просмотр метаданных, меток и шаблонов логов. Отдельно описаны алерты (правила, маршруты уведомлений, контактные точки), инциденты Grafana Incident, расписания и группы алертов Grafana OnCall, аннотации, снимки дашбордов и генерация корректных ссылок на дашборды, панели и Explore.

Часть возможностей выключена по умолчанию и включается в --enabled-tools: запросы к SQL, InfluxDB, CloudWatch, Google Cloud Logging, Graphite, Elasticsearch и OpenSearch, Quickwit, инструменты администрирования, запуск запросов панелей и наблюдаемость агентов в Grafana Cloud.

Когда использовать

Сервер нужен, когда разбор инцидента или поддержка мониторинга идут через ассистента: найти нужный дашборд, объяснить график, составить запрос к метрикам или логам по описанию, посмотреть, какие алерты сработали и кто сейчас дежурит. Для больших дашбордов в README рекомендуют сначала просить краткую сводку или нужное свойство по JSONPath, а не весь JSON, чтобы не тратить контекстное окно модели.

Ограничения и безопасность

Нужна Grafana версии 9.0 или новее, на более старых часть операций с источниками данных может не работать. Агент действует с правами токена сервисной учётной записи, поэтому создайте её с минимально нужными правами RBAC: README разбирает права и области действия для каждого инструмента и отдельно предупреждает, что готовая роль Editor проще, но выдаёт широкий доступ на чтение и запись.

Режим --disable-write отключает запись (обновление дашбордов, создание папок, инцидентов и алертов, аннотации, снимки), а также инструменты, которые выполняют произвольный SQL и запросы InfluxDB, потому что те могут писать, если позволяют права источника данных. Флаг --disable-query убирает все инструменты, выполняющие запросы к источникам. Образ Docker по умолчанию запускает сервер в режиме SSE: для интеграции с клиентами по stdio добавьте -t stdio. В сетевых режимах SSE и streamable-http задайте MCP_GRAFANA_SERVER_TOKEN, иначе сервер запускается, но пишет в лог ошибку безопасности. Сервер по умолчанию отправляет анонимную статистику использования в Grafana Labs (без аргументов запросов и учётных данных); отключить её можно флагом --usage-stats=disabled или переменной DO_NOT_TRACK=1.

Быстрый старт (uvx)

Нужен установленный uv. Добавьте в конфигурацию MCP-клиента, например Claude Desktop или Cursor. Для Grafana Cloud замените GRAFANA_URL адресом вашего экземпляра, например https://myinstance.grafana.net.

{
  "mcpServers": {
    "grafana": {
      "command": "uvx",
      "args": ["mcp-grafana"],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
      }
    }
  }
}

Перед этим создайте в Grafana сервисную учётную запись с нужными правами и выпустите для неё токен.

Docker (stdio)

Флаг -t stdio обязателен: по умолчанию образ запускает сервер в режиме SSE.

docker pull grafana/mcp-grafana
# For local Grafana:
docker run --rm -i -e GRAFANA_URL=http://localhost:3000 -e GRAFANA_SERVICE_ACCOUNT_TOKEN=<your service account token> grafana/mcp-grafana -t stdio
# For Grafana Cloud:
docker run --rm -i -e GRAFANA_URL=https://myinstance.grafana.net -e GRAFANA_SERVICE_ACCOUNT_TOKEN=<your service account token> grafana/mcp-grafana -t stdio

Конфигурация клиента с Docker:

{
  "mcpServers": {
    "grafana": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "GRAFANA_URL",
        "-e",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN",
        "grafana/mcp-grafana",
        "-t",
        "stdio"
      ],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
      }
    }
  }
}

Streamable HTTP через Docker

Порт 8000 нужно опубликовать, а режим задать явно. MCP_GRAFANA_SERVER_TOKEN требует от клиентов заголовок Authorization: Bearer <token>.

docker pull grafana/mcp-grafana
docker run --rm -p 8000:8000 -e GRAFANA_URL=http://localhost:3000 -e GRAFANA_SERVICE_ACCOUNT_TOKEN=<your service account token> -e MCP_GRAFANA_SERVER_TOKEN=<caller auth token> grafana/mcp-grafana -t streamable-http

Другие способы

Бинарный файл можно скачать на странице релизов репозитория и положить в $PATH. Сборка из исходников (нужен Go):

GOBIN="$HOME/go/bin" go install github.com/grafana/mcp-grafana/v2/cmd/mcp-grafana@latest

Развёртывание в Kubernetes через Helm:

helm repo add grafana https://grafana.github.io/helm-charts
helm install --set grafana.apiKey=<Grafana_ApiKey> --set grafana.url=<GrafanaUrl> my-release grafana/grafana-mcp