MCP-сервер Яндекс Метрики (ymetrika-mcp)
Yandex Metrika MCP Server
MCP-сервер на FastMCP с отчетами Яндекс Метрики: визиты, источники трафика, демография, конверсии по целям
- 0 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Запускает Python-сервер по HTTP на порту 8000, который по OAuth-токену читает отчеты Метрики
- Токен лучше выпускать со scope metrika:read
nnstd-cloud-ru-hack-2025/ymetrika-mcp
Похожий инструмент с большим сообществом: Yandex Metrika MCP, 24 ★ репозитория
Установка
- Работает в
- Сервисы
Ручная установка
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-сервер по HTTP на порту 8000, который по OAuth-токену читает отчеты Метрики
- Токен лучше выпускать со scope metrika:read
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на 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 за последнюю неделюMCP
- Транспорт
- http
- Авторизация
- API-ключ
Переменные окружения
YANDEX_API_KEYобязательная, секрет- OAuth-токен Яндекса с доступом на чтение к Метрике
YANDEX_COUNTER_ID- Счетчик Метрики по умолчанию
PORT- Порт сервера, по умолчанию 8000
ENVIRONMENT- Режим development или production, в production обязателен YANDEX_API_KEY
Ограничения
Реализовано только пять отчетных инструментов и ping, остальные методы Метрики (Logs API, управление, импорт) не покрыты. Сервер работает только по streamable HTTP, режима stdio нет. Нужен OAuth-токен Яндекса с доступом к Метрике. В README нет готового npx или uvx запуска, только клонирование и uv sync.
Как отключить. Остановите процесс или контейнер сервера и удалите его адрес из настроек MCP клиента.
Частые вопросы
Можно ли использовать без Docker?
Да, через uv sync и uv run python src/server.py, сервер поднимется на http://0.0.0.0:8000.
Меняет ли сервер что-то в аккаунте Метрики?
Нет, все пять инструментов только читают отчеты, записи в аккаунт нет.
Обсуждение
Вопросов и отзывов пока нет.
Yandex Metrika MCP
Yandex Metrika MCP Server
MCP-сервер для отчетов Яндекс Метрики: трафик, источники, поисковые фразы, цели, география, устройства и контент-аналитика
MCP Яндекс Метрики с управлением счетчиками
@theyahia/yandex-metrika-mcp
MCP-сервер Яндекс Метрики на 15 инструментов: отчеты и трафик плюс создание, изменение и удаление счетчиков и целей
Yandex Metrica MCP
yandex-metrica-mcp
MCP-сервер для Яндекс Метрики только на чтение: отчеты, сравнение периодов, цели и выгрузка сырых логов с входом через браузер
MCP для полного API Яндекс Метрики
mcp-server-yandex-metrika
MCP-сервер, CLI и Pydantic-модели для API Яндекс Метрики: отчеты, счетчики, цели, фильтры, сегменты, логи и загрузка офлайн-конверсий
MCP Яндекс Метрики со всеми 108 методами API
Yandex Metrika MCP Server
MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа
MCP аналитики Яндекс Метрики на 31 инструмент
ya-metrics-mcp
Read-only MCP-сервер Яндекс Метрики: 31 инструмент по трафику, контенту, демографии, географии, конверсиям и e-commerce, только с правом metrika:read
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MCP-сервер Яндекс Метрики (ymetrika-mcp) (эта карточка) | нет | API-ключ | 0 | |
| MCP Яндекс Метрики с исправлениями отчетов | нет | API-ключ | 1 | read-only, 25 инструментов, с исправлением отчетов |
| MCP Яндекс Метрики с управлением счетчиками | нет | API-ключ | 1 | управление счетчиками и целями |
| Яндекс Метрика MCP с DuckDB | нет | API-ключ | 0 | считает сырые логи Метрики локально в DuckDB |
Коротко о README
README описывает быстрый старт через uv и через Docker, список эндпоинтов (mcp, metrics, health) и подробные параметры каждого из пяти инструментов с примерами JSON-запросов и ответов. Отдельные разделы посвящены переменным окружения, получению OAuth-токена metrika:read, трейсингу OpenTelemetry, метрикам Prometheus и структуре проекта. В конце дорожная карта: фаза с базовыми инструментами закрыта, дальше batch-отчеты и мультисчетчики.