MCP-сервер Яндекс Метрики (ymetrika-mcp)
Yandex Metrika MCP Server
MCP-сервер на FastMCP с отчетами Яндекс Метрики: визиты, источники трафика, демография, конверсии по целям
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Все инструменты только читают отчетную статистику Метрики
- Токен стоит выпускать со scope metrika:read, без прав записи
Установка
Ручная установка
docker build -t yandex-metrika-mcp . && docker run -p 8000:8000 -e YANDEX_API_KEY=your_api_key_here yandex-metrika-mcpСборка и запуск контейнера из README, сервер слушает 8000 порт.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на Python и FastMCP поднимает MCP по streamable HTTP и дает пять инструментов поверх Reporting API Метрики: информация о счетчике, визиты за период, разбивка по источникам трафика, демография пользователей и конверсии по целям. Есть диагностический инструмент ping для проверки транспорта. Каждый вызов оборачивается трейсом OpenTelemetry, сервер отдает метрики Prometheus на /metrics и статус на /health. Запускается локально через uv или в Docker с непривилегированным пользователем.
Для кого. Для команд, которым нужен наблюдаемый MCP-сервер отчетов Метрики с трейсингом и метриками для собственной инфраструктуры.
Подходит, если
- Нужны базовые отчеты Метрики (визиты, источники, демография, цели) через MCP
- Важна наблюдаемость: трейсы OpenTelemetry и метрики Prometheus на своем сервере
- Планируется деплой в Docker рядом с остальной инфраструктурой мониторинга
Не подходит, если
- Нужен полный набор отчетов Stat API или Logs API: здесь только пять готовых инструментов
- Нужна работа с Direct или Webmaster в одном сервере
Пример запроса к агенту
Покажи визиты и источники трафика по счетчику 12345678 за последнюю неделюОграничения
Реализовано только пять отчетных инструментов и ping, остальные методы Метрики (Logs API, управление, импорт) не покрыты. Сервер работает только по streamable HTTP, режима stdio нет. Нужен OAuth-токен Яндекса с доступом к Метрике. В README нет готового npx или uvx запуска, только клонирование и uv sync.
Как отключить. Остановите процесс или контейнер сервера и удалите его адрес из настроек MCP клиента.
MCP
- Транспорт
- http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YANDEX_API_KEY обязательная, секрет | OAuth-токен Яндекса с доступом на чтение к Метрике |
| YANDEX_COUNTER_ID | Счетчик Метрики по умолчанию |
| PORT | Порт сервера, по умолчанию 8000 |
| ENVIRONMENT | Режим development или production, в production обязателен YANDEX_API_KEY |
Проверка безопасности
- Все инструменты только читают отчетную статистику Метрики
- Токен стоит выпускать со scope metrika:read, без прав записи
Коротко о README
README описывает быстрый старт через uv и через Docker, список эндпоинтов (mcp, metrics, health) и подробные параметры каждого из пяти инструментов с примерами JSON-запросов и ответов. Отдельные разделы посвящены переменным окружения, получению OAuth-токена metrika:read, трейсингу OpenTelemetry, метрикам Prometheus и структуре проекта. В конце дорожная карта: фаза с базовыми инструментами закрыта, дальше batch-отчеты и мультисчетчики.
Частые вопросы
Можно ли использовать без Docker?
Да, через uv sync и uv run python src/server.py, сервер поднимется на http://0.0.0.0:8000.
Меняет ли сервер что-то в аккаунте Метрики?
Нет, все пять инструментов только читают отчеты, записи в аккаунт нет.
Похожие
Скиллы DataLens
DataLens Skills
Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS
MCP Яндекс Метрики со всеми 108 методами API
Yandex Metrika MCP Server
MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа
Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO
Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов