io.github.grafana/mcp-grafana
MCP server, дающий доступ к Grafana dashboards, данным и многому другому.
Что это
MCP server, дающий доступ к Grafana dashboards, данным и многому другому.
Как подключить
Вставьте блок в конфиг клиента (Claude Desktop, Claude Code, Cursor, VS Code, Cline). Команда и package собраны из полей официального MCP Registry.
Что нового в версиях
Исправлена критическая ошибка потери структуры v2 при обновлении дашбордов, добавлена поддержка схемы v2 в запросах панелей.
- Исправленоupdate_dashboard больше не перезаписывает дашборды v1 в v2, возвращая ошибку вместо молчаливой потери структуры.
- Исправленоrun_panel_query теперь корректно работает с дашбордами по схеме v2, устраняя ошибку отсутствия панелей.
- ИсправленоИсправлена обработка HTML-ответов от fallback-маршрутов, предотвращающая ошибки парсинга до перезапуска.
- ИсправленоИсправлено экранирование запятых в описаниях инструментов и улучшена совместимость CSP для встраивания ресурсов.
Переход на официальный MCP Go SDK, разделение инструментов алертинга на чтение/запись и удаление Sift.
- Ломает совместимостьСервер переписан на официальный MCP Go SDK, изменён путь Go-модуля на github.com/grafana/mcp-grafana/v2.
- Ломает совместимостьИнструменты алертинга разделены на read и write версии для поддержки прав доступа только на чтение.
- Ломает совместимостьУдалены устаревшие инструменты Sift и соответствующая категория.
- НовоеДобавлен инструмент alerting_routing_write для создания контактных точек в Grafana.
- Статистика использования включена по умолчанию; отключается через флаг --usage-stats=disabled.
Исправлена обработка ошибок Prometheus и версий в Docker-образах. Добавлено блокирование перенаправлений между разными схемами/хостами для защиты учётных данных.
- Ломает совместимостьЗапрещены перенаправления (redirects) к другим схемам, хостам или портам для защиты учётных данных Grafana. Для восстановления старого поведения используйте флаг --allow-cross-origin-redirects.
- ИсправленоТеперь ошибки Prometheus, отличные от 400/422 (например, 500 или ошибки прокси), включают тело ответа, что позволяет точно понять причину сбоя.
- ИсправленоDocker-образы теперь корректно отображают версию релиза, а не используют fallback из build-info.
Последний релиз серии 1.x перед выходом версии 2.0; исправления в Loki/VictoriaLogs, оптимизация размера пакетов и багфиксы.
- Это последний релиз ветки 1.x, следующий будет версии 2.0.
- ИсправленоЗапросы к Loki теперь возвращают логи в хронологическом порядке и не теряют строки на границах пакетов.
- ИсправленоВ запросах Loki и VictoriaLogs сохранена наносекундная точность временных границ для узких окон.
- ИсправленоИсправлена ошибка с двойным слэшем в путях запросов при указании URL Grafana с завершающим слэшем.
- ИсправленоРазмер PyPI-пакетов сокращен с 55 МБ до 17 МБ за счет сжатия встроенных бинарных файлов.
Исправлено зависание stdio-сервера при использовании подписок и ошибка подстановки пустых полей в Claude Desktop.
- ИсправленоСтандартный сервер (stdio) больше не перестает отвечать на запросы после открытия потока subscriptions/listen, что устраняло таймауты tools/list в Claude Code и GitHub Copilot CLI.
- ИсправленоВ расширении Claude Desktop (MCPB) исправлена передача пустых опциональных полей: теперь они не подставляют литеральные плейсхолдеры ${user_config.*} как учетные данные, что восстанавливает аутентифик
Добавлена поддержка Google Cloud Logging, выбор Grafana URL на запрос и улучшения для Tempo/Loki; исправлены проблемы с памятью и путями.
- НовоеДобавлена категория инструментов cloudlogging для Google Cloud Logging с функциями запросов и обнаружения ресурсов.
- НовоеПоявилась опция выбора URL Grafana для каждого запроса с поддержкой allowlist и токенов.
- НовоеИнструменты Tempo TraceQL теперь содержат примеры грамматики и подсказки для исправления ошибок PromQL.
- Исправленоlist_prometheus_metric_names теперь использует фильтрацию и лимиты на стороне дата-источника, избегая скачков памяти.
- ИсправленоИсправлена работа флага --base-path для HTTP и SSE, а также улучшена обработка пустых запросов в Loki и VictoriaLogs.
Исправлена генерация коротких ссылок, тип параметра limit и поля TLS-схемы.
- Исправленоshorten_url больше не дублирует префикс подкаталога при генерации коротких ссылок.
- Исправленоget_annotation_tags теперь принимает limit как число, устраняя ошибки типов.
- ИсправленоИз полей TLS-схемы удалены плейсхолдеры PEM, чтобы не вводить LLM в заблуждение.
Версия 1.5.0: добавлена анонимная статистика, улучшена работа с Loki и оптимизированы вызовы Tempo API.
- НовоеДобавлена сборка анонимной статистики использования с настраиваемыми режимами и защитой DO_NOT_TRACK.
- НовоеВ GrafanaConfig добавлено поле UserAgent для идентификации вызывающих API.
- ИсправленоИсправлено сохранение структурированных метаданных в query_loki_logs при компактном формате вывода.
- НовоеИнструменты Tempo теперь используют прямые HTTP-вызовы к API, минуя MCP-прокси для повышения надежности.
Все релизы на GitHub → Пересказ на русском — по заметкам к релизам и коммитам.