@atsorganization/tracker-mcp

MCP-сервер для запросов к данным трекера через BFF API. Позволяет AI-агентам анализировать трафик на естественном языке.

Требования

• Node.js >= 18

Переменные окружения

| Переменная | Описание | |------------|----------| | API_TOKEN | Токен авторизации для BFF API | | API_URL | URL BFF API |

Обе переменные обязательны -- сервер не запустится без них.

Установка

Через npx (рекомендуется)

npx -y @atsorganization/tracker-mcp

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

git clone https://github.com/atsorganization/tracker-mcp.git
cd tracker-mcp
npm ci
npm run build

Запуск:

node /absolute/path/to/tracker-mcp/dist/index.js

Настройка AI-агента

Добавьте конфигурацию MCP-сервера в настройки вашего AI-агента (Claude Desktop, Claude Code, Cursor и др.):

{
  "tracker": {
    "command": "npx",
    "args": ["-y", "@atsorganization/tracker-mcp"],
    "env": {
      "API_TOKEN": "YOUR_API_TOKEN",
      "API_URL": "https://example.com"
    }
  }
}

Замените YOUR_API_TOKEN на ваш токен и https://example.com на URL вашего BFF API.

Примеры запросов

Вот что можно спросить у AI-агента после подключения сервера:

1. "Покажи дневную сводку по ключевым метрикам за вчера"
2. "Топ-10 стран по профиту за последнюю неделю"
3. "Почасовая разбивка показов и профита за сегодня"
4. "Какие метрики доступны в трекере?"
5. "Отчёт по бандлам с фильтром country in US,DE за последние 3 дня"

Доступные инструменты

| Инструмент | Описание | |------------|----------| | list_dimensions | Список доступных измерений | | list_metrics | Список доступных метрик | | get_report | Отчёт по измерениям и метрикам с фильтрами |

Доступные промпты

| Промпт | Описание | |--------|----------| | daily-summary | Дневная сводка по ключевым метрикам | | top-by-metric | Топ N по выбранной метрике | | hourly-breakdown | Почасовая разбивка за указанный день |

Публикация (для разработчиков)

Публикация происходит автоматически при создании тега:

git tag v1.0.0
git push origin v1.0.0