mcp-grafana

mcp-grafana

grafanaApache-2.0
3.1k звёзд369 форков
MCP-сервер от команды Grafana Labs, который подключает AI-ассистентов к мониторинговой платформе Grafana. Через него можно искать дашборды, запрашивать метрики из панелей и работать с источниками данных. Всё — через текстовые команды без интерфейса. Сервер пригодится DevOps-инженерам и разработчикам, которые хотят ускорить анализ инцидентов. Достаточно попросить ассистента показать график загрузки CPU или найти дашборд по названию — и AI сам сходит в Grafana и вернёт ответ. Поддерживаются локальные серверы Grafana (версия 9.0 и выше) и Grafana Cloud. Для работы нужен сервисный аккаунт с токеном доступа.
MonitoringGrafana
Открыть на GitHub

Характеристики

Общее

  • СтатусСообщество
  • Разработчикgrafana
  • ЛицензияApache-2.0

Технологии

  • Языки
    Go
  • Транспорт
    streamable-httpstdio

Описание

Возможности

  • Поиск дашбордов по названию и тегам — получайте список дашбордов, удовлетворяющих условию
  • Просмотр структуры дашборда: панели, их заголовки, типы графиков, запросы и опции
  • Выполнение запросов к настроенным источникам данных (Prometheus, Loki, Graphite, InfluxDB и другие) через API Grafana
  • Извлечение значений метрик за заданный временной диапазон
  • Просмотр списка всех источников данных с их типом и URL
  • Экспорт дашборда в JSON
  • Управление дашбордами через API: создание, обновление, удаление
  • Работа с Grafana Cloud: используйте тот же сервер, просто указав облачный URL и токен

Как подключить

1. Установите uv — менеджер проектов Python. Инструкция на сайте uv. Он нужен для выполнения uvx.

2. Настройте сервисный аккаунт в Grafana — создайте Service Account с необходимыми правами и скопируйте токен.

3. Добавьте конфигурацию в ваш MCP-клиент. Для Claude Desktop отредактируйте файл claude_desktop_config.json:

{ "mcpServers": { "grafana": { "command": "uvx", "args": ["mcp-grafana"], "env": { "GRAFANA_URL": "http://localhost:3000", "GRAFANA_SERVICE_ACCOUNT_TOKEN": "glsa_..." } } } }

Если вы используете Grafana Cloud, замените GRAFANA_URL на адрес вашего инстанса, например https://myinstance.grafana.net.

4. Перезапустите клиент — после сохранения конфига перезагрузите программу. В списке инструментов появится «grafana».

Альтернативные способы установки: Docker, бинарник (скачивается с GitHub) и Helm-чарт. Подробнее — в репозитории проекта.

Примеры запросов

  • «Покажи список дашбордов, которые отслеживают состояние Kubernetes»
  • «Найди дашборд с названием Node Exporter Full и выведи все его панели с типом графика»
  • «Получи данные панели CPU Usage за последние 3 часа с интервалом 1 минута»
  • «Создай новый дашборд с одним графиком запроса sum(rate(node_cpu_seconds_total[5m])) и выводом за последний час»

Технические детали

  • Язык реализации: Go
  • Транспорт: streamable-http и stdio
  • Лицензия: Apache-2.0
  • Разработчик: Grafana Labs
  • Совместимые клиенты: Claude Desktop, Cursor и любые другие, поддерживающие MCP через stdio

Поделиться