MCP-сервер Яндекс Метрики только для чтения

Установка

Ручная установка

python3 -m venv .venv && . .venv/bin/activate && pip install -e .

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер оборачивает API Яндекс Метрики в 12 инструментов только для чтения: обнаружение структуры аккаунта (счетчики, цели, сегменты, фильтры, права доступа, метки), произвольные табличные отчеты с метриками, измерениями, фильтрами и сортировкой, разбивку по времени и по значению одного измерения, сравнение двух периодов равной длины. Сервер намеренно не оборачивает весь API построчно, чтобы не раздувать промпт модели, и использует правильный заголовок Authorization OAuth, а не Bearer, на котором спотыкаются другие реализации. В комплекте лежит парный SKILL.md для Hermes Agent, который задает методику анализа: сначала список счетчиков, потом сравнимые по длительности периоды, разложение изменения по источнику, странице, устройству, проверка качества трафика и метка уверенности в выводе.

Для кого. Для маркетинговых аналитиков, которым нужны точные отчеты Метрики без риска, что агент случайно что-то изменит в счетчике.

Пример запроса к агенту

Сравни трафик за этот и прошлый месяц и разложи изменение по источникам

Ограничения

Нужен OAuth-токен Метрики в переменной окружения YANDEX_METRIKA_TOKEN, сервер сам собирает заголовок Authorization OAuth. Готового пакета в PyPI нет, установка только из исходников через pip install -e . или uv tool install. Сопроводительный скилл написан под формат Hermes Agent, для других агентов методику анализа придется переносить вручную.

Как отключить. Удалите блок yandex-metrika-mcp из конфигурации MCP клиента или переменную YANDEX_METRIKA_TOKEN из окружения.

MCP

Транспорт

stdio

Авторизация

API-ключ

Проверка безопасности

• Только чтение данных Метрики, инструментов записи или изменения настроек нет

Коротко о README

README на английском и русском объясняет два слоя: MCP-сервер как слой данных и скилл Hermes Agent как слой методики анализа, оба нужны вместе для полноценной работы. Перечислены инструменты обнаружения структуры и отчетов, объяснена причина минимального набора вместо полного покрытия API, показаны установка через pip или uv, переменная токена и обертка для Hermes, которая прячет токен из редактируемого конфига. Указана лицензия MIT.

Похожие