Об этом проекте

Grafana MCP server — это сервер Model Context Protocol (MCP), который подключает MCP-клиенты, такие как Claude Desktop или Cursor, к экземпляру Grafana и его окружению. Для полной функциональности требуется Grafana 9.0 или новее, поскольку некоторые операции с источниками данных зависят от более новых конечных точек API. Настройка выполняется добавлением записи в конфигурацию MCP-клиента, обычно с запуском сервера через uvx с GRAFANA_URL и токеном сервисной учётной записи в окружении. Также документированы варианты установки через Docker, бинарный файл и Helm. Возможности сгруппированы в категории инструментов, а список инструментов настраивается, поэтому неиспользуемую функциональность можно отключить для экономии места в контекстном окне. Категории можно отключать флагами, такими как --disable-oncall или --disable-navigation, а несколько категорий отключены по умолчанию и должны быть включены через --enabled-tools. Инструменты для дашбордов охватывают поиск по заголовку, UID папки, тегу или статусу избранного; получение дашборда по UID или сохранённой версии; список версий; получение компактной сводки; извлечение частей через JSONPath; создание, обновление и частичное обновление дашбордов; а также чтение запросов панелей с информацией об источнике данных. В README отмечено, что полный JSON дашборда может занимать значительное место в контекстном окне, и вместо него предлагаются инструменты сводки или JSONPath. Поддержка источников данных и запросов включает список и инспектирование источников данных (Prometheus, Loki, ClickHouse, CloudWatch, Elasticsearch, OpenSearch, Snowflake, Athena), мгновенные и диапазонные запросы PromQL, а также метаданные метрик и процентили гистограмм, запросы логов и метрик LogQL с обнаружением меток и шаблонов, InfluxDB через InfluxQL или Flux, унифицированные SQL-инструменты для ClickHouse, Snowflake, Athena, MySQL, PostgreSQL и MSSQL с подстановкой макросов и принудительным ограничением, пространства имён, метрики и измерения CloudWatch, запросы render Graphite и обнаружение метрик, поиск Elasticsearch/OpenSearch и Quickwit, а также получение примеров запросов. SQL-запросы выполняются через плагины источников данных Grafana, поэтому учётные данные обрабатываются конфигурацией источника данных, а не сервером MCP. Операционные области включают алертинг (список, создание, обновление, удаление правил; политики уведомлений, точки контакта, интервалы времени), Grafana Incident (поиск, создание, обновление, пользовательские поля), расследования Sift (список, детали, анализы, обнаружение шаблонов ошибок и медленных запросов), Grafana OnCall (расписания, смены, текущие дежурные пользователи, команды, пользователи, группы алертов), аннотации (запрос, создание, обновление, частичное обновление, удаление, теги), снимки (список, получение, создание, удаление), рендеринг панелей или дашбордов в PNG через Grafana Image Renderer, список репозитория провижининга и проверку dry-run, генерацию deeplink для дашбордов, панелей и Explore, а также поиск идентичности пользователя для запросов в нескольких организациях. Инструменты Agent Observability, доступные только в Grafana Cloud, охватывают список и поиск диалогов LLM, детали диалогов и генераций с оценками, каталог агентов с историей версий и оценками токенов, оценщики и шаблоны, правила и защиты eval, сохранённые диалоги и коллекции, тестовые наборы и офлайн-эксперименты. Некоторые из них включают операции записи, ограниченные определённым разрешением. Инструменты Grafana Assistant отправляют запросы на естественном языке ассистенту и поддерживают продолжение диалога через возвращённый context ID; это инструменты записи, и они пропускаются, когда задан --disable-write. Контроль доступа основан на RBAC: каждому инструменту требуются определённые разрешения и области действия, и README рекомендует создать сервисную учётную запись с необходимыми правами, отмечая, что встроенная роль Editor — более простой, но менее гранулярный вариант. Инструменты Incident и Sift используют базовые роли Viewer/Editor вместо тонко настроенных разрешений. README содержит таблицу инструментов, сопоставляющую имена инструментов с категориями, требуемыми разрешениями RBAC и требуемыми областями действия.