AIKraft Agents

grafana/mcp-grafana

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

MCP⭐ 3 644Goпоследний релиз: v2.2.0
Открыть на 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 и ИИ-ассистентов

Релизы

v2.2.0minorbreaking
🕐 3 дн назад · релиз на GitHub ↗

Добавлены инструменты CloudWatch, ресурсы источников данных, защита запросов Prometheus/Loki и поддержка BigQuery; улучшена обработка панелей.

  • Added: Добавлены инструменты CloudWatch Logs Insights для поиска и запросов по логам с поддержкой кросс-аккаунтов.
  • Added: Источники данных экспортированы как MCP-ресурсы, позволяя клиентам прикреплять их к диалогу через пикер.
  • Added: Внедрены guardrails для Prometheus и Loki: контроль временных диапазонов, количества точек и оценки стоимости запросов.
  • Added: Добавлена поддержка BigQuery в SQL-инструментах без использования INFORMATION_SCHEMA для экономии средств.
  • Breaking: query_prometheus и get_tempo_trace больше не открывают приложение самостоятельно; визуализация перенесена в render_grafana_app.
  • Fixed: Улучшена обработка переменных, макросов и источников данных в run_panel_query для сложных дашбордов.
v2.1.1patch
🕐 16 дн назад · релиз на GitHub ↗

Исправлена ошибка, из-за которой классические дашборды v1 ошибочно обновлялись до v2, ломая патчинг.

  • Fixed: Исправлено некорректное определение версии: классические дашборды v1 теперь правильно распознаются как v1, а не v2.
  • Fixed: Возвращена корректная работа функции update_dashboard, которая ранее падала из-за неверных путей к панелям.
  • Fixed: Устранена проблема самопроизвольной миграции дашбордов v2 на версиях Grafana Cloud 13.3 и новее.
v2.0.2minor
🕐 29 дн назад · релиз на GitHub ↗

v2.0.2: добавлена генерация изображений панелей через Explore, исправлена поддержка перцентилей в CloudWatch и улучшены описания инструментов.

  • Added: get_panel_image теперь поддерживает рендеринг временных представлений Explore в PNG без сохранения дашборда (требует Grafana 10.2+).
  • Added: update_dashboard возвращает абсолютную ссылку на дашборд в поле url, используя публичный URL, если он доступен.
  • Fixed: query_cloudwatch теперь корректно принимает статистики перцентилей, такие как p95 и p99.9, ранее доступные только базовые значения.
  • Fixed: Описания инструментов и параметров очищены от директив для моделей и ссылок на другие инструменты в соответствии с требованиями каталога.
v2.0.1patch
🕐 1 мес назад · релиз на GitHub ↗

Исправлена критическая ошибка потери структуры v2 при обновлении дашбордов, добавлена поддержка схемы v2 в запросах панелей.

  • Fixed: update_dashboard больше не перезаписывает дашборды v1 в v2, возвращая ошибку вместо молчаливой потери структуры.
  • Fixed: run_panel_query теперь корректно работает с дашбордами по схеме v2, устраняя ошибку отсутствия панелей.
  • Fixed: Исправлена обработка HTML-ответов от fallback-маршрутов, предотвращающая ошибки парсинга до перезапуска.
  • Fixed: Исправлено экранирование запятых в описаниях инструментов и улучшена совместимость CSP для встраивания ресурсов.
v2.0.0majorbreaking
🕐 1 мес назад · релиз на GitHub ↗

Переход на официальный MCP Go SDK, разделение инструментов алертинга на чтение/запись и удаление Sift.

  • Breaking: Сервер переписан на официальный MCP Go SDK, изменён путь Go-модуля на github.com/grafana/mcp-grafana/v2.
  • Breaking: Инструменты алертинга разделены на read и write версии для поддержки прав доступа только на чтение.
  • Breaking: Удалены устаревшие инструменты Sift и соответствующая категория.
  • Added: Добавлен инструмент alerting_routing_write для создания контактных точек в Grafana.
  • Статистика использования включена по умолчанию; отключается через флаг --usage-stats=disabled.
v1.6.3patchbreaking
🕐 1 мес назад · релиз на GitHub ↗

Исправлена обработка ошибок Prometheus и версий в Docker-образах. Добавлено блокирование перенаправлений между разными схемами/хостами для защиты учётных данных.

  • Breaking: Запрещены перенаправления (redirects) к другим схемам, хостам или портам для защиты учётных данных Grafana. Для восстановления старого поведения используйте флаг --allow-cross-origin-redirects.
  • Fixed: Теперь ошибки Prometheus, отличные от 400/422 (например, 500 или ошибки прокси), включают тело ответа, что позволяет точно понять причину сбоя.
  • Fixed: Docker-образы теперь корректно отображают версию релиза, а не используют fallback из build-info.
v1.6.2patch
🕐 1 мес назад · релиз на GitHub ↗

Последний релиз серии 1.x перед выходом версии 2.0; исправления в Loki/VictoriaLogs, оптимизация размера пакетов и багфиксы.

  • Это последний релиз ветки 1.x, следующий будет версии 2.0.
  • Fixed: Запросы к Loki теперь возвращают логи в хронологическом порядке и не теряют строки на границах пакетов.
  • Fixed: В запросах Loki и VictoriaLogs сохранена наносекундная точность временных границ для узких окон.
  • Fixed: Исправлена ошибка с двойным слэшем в путях запросов при указании URL Grafana с завершающим слэшем.
  • Fixed: Размер PyPI-пакетов сокращен с 55 МБ до 17 МБ за счет сжатия встроенных бинарных файлов.
v1.6.1patch
🕐 1 мес назад · релиз на GitHub ↗

Исправлено зависание stdio-сервера при использовании подписок и ошибка подстановки пустых полей в Claude Desktop.

  • Fixed: Стандартный сервер (stdio) больше не перестает отвечать на запросы после открытия потока subscriptions/listen, что устраняло таймауты tools/list в Claude Code и GitHub Copilot CLI.
  • Fixed: В расширении Claude Desktop (MCPB) исправлена передача пустых опциональных полей: теперь они не подставляют литеральные плейсхолдеры ${user_config.*} как учетные данные, что восстанавливает аутентифик
v1.6.0minor
🕐 1 мес назад · релиз на GitHub ↗

Добавлена поддержка Google Cloud Logging, выбор Grafana URL на запрос и улучшения для Tempo/Loki; исправлены проблемы с памятью и путями.

  • Added: Добавлена категория инструментов cloudlogging для Google Cloud Logging с функциями запросов и обнаружения ресурсов.
  • Added: Появилась опция выбора URL Grafana для каждого запроса с поддержкой allowlist и токенов.
  • Added: Инструменты Tempo TraceQL теперь содержат примеры грамматики и подсказки для исправления ошибок PromQL.
  • Fixed: list_prometheus_metric_names теперь использует фильтрацию и лимиты на стороне дата-источника, избегая скачков памяти.
  • Fixed: Исправлена работа флага --base-path для HTTP и SSE, а также улучшена обработка пустых запросов в Loki и VictoriaLogs.
v1.5.1patch
🕐 1 мес назад · релиз на GitHub ↗

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

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

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

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

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

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

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

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

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

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

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

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