grafana/mcp-grafana

MCP-сервер для Grafana

MCP⭐ 3 475Goпоследний релиз: v1.5.1
Открыть на GitHub ↗

Что это за инструмент

MCP-сервер для Grafana, позволяющий ИИ-агентам взаимодействовать с инстансом Grafana через протокол Model Context Protocol.

Зачем нужен

Инструмент позволяет LLM-клиентам (например, Claude Desktop или Cursor) управлять дашбордами, просматривать метрики и выполнять запросы к различным системам мониторинга без написания кода. Это полезно для автоматизации рутинных задач по анализу данных и администрированию Grafana.

Что можно реализовать

  • Поиск дашбордов по названию или метаданным
  • Получение сводной информации о дашборде (заголовки, типы панелей) без загрузки полного JSON
  • Выполнение запросов PromQL к Prometheus или LogQL к Loki
  • Запуск SQL-запросов к ClickHouse через Grafana
  • Просмотр списка доступных источников данных (datasources) и их конфигураций

Ключевые возможности

  • Поддержка протокола MCP для интеграции с ИИ-ассистентами
  • Оптимизация потребления контекстного окна через инструменты summary и JSONPath
  • Встроенные инструменты для запросов к Prometheus, Loki, InfluxDB, ClickHouse и CloudWatch
  • Возможность создания и обновления дашбордов через API
  • Поддержка Grafana Cloud и локальных инстансов (версия 9.0+)

👤 Кому подойдёт: разработчики, DevOps-инженеры, аналитики данных, использующие Grafana и ИИ-ассистентов

Релизы

v1.5.1patch
🕐 3 дн назад · релиз на GitHub ↗

Исправлена генерация коротких ссылок, тип параметра limit и поля TLS-схемы.

  • Fixed: shorten_url больше не дублирует префикс подкаталога при генерации коротких ссылок.
  • Fixed: get_annotation_tags теперь принимает limit как число, устраняя ошибки типов.
  • Fixed: Из полей TLS-схемы удалены плейсхолдеры PEM, чтобы не вводить LLM в заблуждение.
v1.5.0minor
🕐 4 дн назад · релиз на GitHub ↗

Версия 1.5.0: добавлена анонимная статистика, улучшена работа с Loki и оптимизированы вызовы Tempo API.

  • Added: Добавлена сборка анонимной статистики использования с настраиваемыми режимами и защитой DO_NOT_TRACK.
  • Added: В GrafanaConfig добавлено поле UserAgent для идентификации вызывающих API.
  • Fixed: Исправлено сохранение структурированных метаданных в query_loki_logs при компактном формате вывода.
  • Added: Инструменты Tempo теперь используют прямые HTTP-вызовы к API, минуя MCP-прокси для повышения надежности.
v1.4.2minor
🕐 6 дн назад · релиз на GitHub ↗

Добавлена поддержка версий дашбордов и исправлено нарушение схемы MCP, ломавшее старые клиенты.

  • Added: Добавлен параметр version для get_dashboard_by_uid и новый инструмент list_dashboard_versions для получения метаданных версий.
  • Fixed: Убрано принудительное добавление полей в ответ tools/list, которое нарушало базовую схему протокола и ломало легаси-клиенты MCP.
v1.4.1minorbreaking
🕐 10 дн назад · релиз на GitHub ↗

В v1.4.1 добавлен labelSelector для Sift-инструментов и исправлено определение типа датастора в run_panel_query.

  • Added: В инструменты Sift (find_error_pattern_logs, find_slow_requests) добавлен параметр labelSelector, принимающий синтаксис PromQL/LogQL для фильтрации по регулярным выражениям и отрицательным матчерам.
  • Breaking: Параметр labels в инструментах Sift удален и заменен на labelSelector, что является ломающим изменением.
  • Fixed: Функция run_panel_query теперь определяет тип датастора по его реальному типу, а не по записи в панели, что предотвращает обход ограничений Loki через некорректно помеченные панели.
  • Fixed: Исправлено ложное предупреждение о дефолтной организации при запуске, если включена поддержка динамических мульти-органайзаций.
v1.4.0minor
🕐 10 дн назад · релиз на GitHub ↗

Объединение SQL-инструментов, новые фильтры для поиска и логирования, улучшение безопасности Loki и исправление ошибок.

  • Added: Объединены инструменты SQL-запросов в единую систему диалектов для упрощения поддержки.
  • Added: Добавлены фильтры folderUid, tag, starred для поиска дашбордов и параметр matcher для логирования Loki.
  • Added: Внедрено принудительное применение LogQL-матчеров для ограничения доступа к потокам логов.
  • Added: Появился инструмент delete_annotation для удаления аннотаций и list_cloudwatch_dimension_values для CloudWatch.
  • Fixed: Исправлена фильтрация правил алертинга, обработка ошибок типов аргументов и deeplinks в Explore.
v1.3.0minorbreaking
🕐 23 дн назад · релиз на GitHub ↗

Добавлена поддержка мульти-органов, инструментов документации и кастомных полей инцидентов; улучшена безопасность запросов.

  • Added: Добавлена опциональная передача orgId для работы с несколькими организациями Grafana (флаг --dynamic-multi-org).
  • Added: Появились инструменты для запросов к документации Grafana и получения информации о текущем пользователе.
  • Added: Поддержка пользовательских полей при создании и обновлении инцидентов.
  • Breaking: get_panel_image больше не принимает аргумент orgId напрямую; организация теперь определяется через нативные инструменты или заголовки.
  • Added: Инструменты raw-SQL запросов по умолчанию защищены флагом --disable-write.
v1.1.0minor
🕐 1 мес назад · релиз на GitHub ↗

Добавлена аутентификация по токену, инструменты для Grafana Assistant и Agent Observability, улучшена observability.

  • Added: Добавлена опциональная аутентификация по bearer-токену для SSE и streamable-http транспортов.
  • Added: Появился инструмент ask_assistant для открытых вопросов к Grafana Assistant.
  • Added: Добавлены инструменты observability для управления агентами, коллекциями и оценками (Agent Observability).
  • Fixed: Исправлено неконтролируемое рост памяти в прокси-инструментах и добавлены метки безопасности для всех инструментов.
  • Added: query_pyroscope теперь по умолчанию возвращает таблицу по функциям, а не DOT-граф.
v1.0.0majorbreaking
🕐 1 мес назад · релиз на GitHub ↗

Релиз v1.0.0: добавлены инструменты наблюдаемости агентов, улучшен просмотр панелей и настройка OTLP, введены строгие проверки аргументов.

  • Added: Добавлены инструменты наблюдаемости агентов (agento11y_manage_conversations и agento11y_manage_generations) в отдельную категорию, исключенную из набора по умолчанию.
  • Added: Реализован встроенный просмотрщик изображений панелей для хостов, поддерживающих MCP, с резервным переходом по ссылке на дашборд.
  • Fixed: Появилась возможность экспортировать только трейлы через переменную OTEL_EXPORTER_OTLP_TRACES_ENDPOINT, не затрагивая логи.
  • Breaking: Вызовы инструментов с неизвестными ключами аргументов теперь отклоняются с ошибкой, а не игнорируются с использованием значений по умолчанию.
v0.17.1patch
🕐 2 мес назад · релиз на GitHub ↗

Исправлена передача путей для глубоких ссылок и устранена уязвимость DNS-rebinding в HTTP и SSE.

  • Fixed: Исправлена отправка относительных путей в short-urls API для генерации навигационных deeplinks.
  • Заблокированы атаки DNS rebinding на транспортных протоколах HTTP и SSE.
v0.17.0minor
🕐 3 мес назад · релиз на GitHub ↗

Добавлены инструменты управления источниками данных через MCP с валидацией по JSON-схеме. Исправлено распознавание rawSQL в плагине Athena.

  • Added: Появились инструменты для создания и обновления источников данных через MCP-сервер с конфигурацией по JSON-схеме и защитой чувствительных данных.
  • Fixed: Исправлено распознавание поля rawSQL в плагине Athena при извлечении запросов из панелей дашбордов.