Intervals MCP

Русская версия

Самостоятельно размещаемый MCP-сервер только для чтения, который предоставляет ИИ-ассистентам доступ к тренировочным данным спортсмена из Intervals.icu.

Подключите спортивные часы, велокомпьютер, тренажёр, Strava или другой поддерживаемый источник к Intervals.icu. Затем Intervals MCP предоставляет нормализованные тренировочные данные ChatGPT, Claude, Claude Code, Cursor, VS Code и другим MCP-клиентам. Актуальный список интеграций см. на Intervals.icu; он меняется со временем.

Сервер выполняет только GET-запросы. Он не может создавать, изменять или удалять что-либо в аккаунте спортсмена в Intervals.icu.

Что может читать ассистент

• Профиль спортсмена, часовой пояс, настройки видов спорта, зоны, FTP, LTHR и максимальный пульс.

• Активности, детали, круги, интервалы и прореженные потоки данных.

• Самочувствие, форму, усталость, вариабельность сердечного ритма, сон, настроение и вес, если они доступны.

• Запланированные события, кривые лучших усилий, инвентарь и библиотеку тренировок.

• Дополнительные GET-эндпоинты Intervals.icu v1 через инструмент raw только для чтения.

Большие ответы сжимаются до того, как попадают в модель. Пустые поля отбрасываются, потоки прореживаются, а сводки используют полные ряды данных.

Related MCP server: intervals.mcp

Быстрый старт

Вам нужен VPS на Ubuntu или Debian с публичным именем хоста. Укажите DNS-запись имени хоста на сервер и разрешите входящие TCP-порты 80 и 443. Установщик добавляет Docker, Compose, Git и uv, если они отсутствуют:

curl -fsSL https://raw.githubusercontent.com/VictorForV/intervals-mcp/master/install.sh | sudo bash

Просмотрите install.sh перед запуском, если вы предпочитаете не передавать удалённый скрипт в привилегированную оболочку. Ручная установка остаётся доступной: клонируйте репозиторий и запустите ./manage.sh после установки необходимых компонентов.

Выберите Initial setup. Менеджер запросит публичное имя хоста, короткое имя спортсмена, а также ID спортсмена и API-ключ Intervals.icu. ID и ключ доступны в разделе Settings → Developer Settings в Intervals.icu. API-ключ вводится в скрытом режиме.

Менеджер создаёт конфигурацию, доступную только владельцу, генерирует надёжный случайный URL-токен, запускает службу и выводит URL-адреса коннекторов. Позже запустите ./manage.sh, чтобы добавить, вывести список, изменить или удалить спортсменов, сменить URL-адреса, пересобрать, перезапустить или проверить службу.

Подключение ИИ-клиента

Каждый спортсмен получает два секретных URL-адреса:

https://mcp.example.com/<secret>/mcp  # Streamable HTTP, preferred
https://mcp.example.com/<secret>/sse  # legacy SSE compatibility

Относитесь к полному URL-адресу как к паролю. Он предоставляет доступ на чтение к тренировочным и оздоровительным данным этого спортсмена.

Claude и Claude Desktop

Откройте Settings → Connectors → Add custom connector и введите URL-адрес /mcp. Доступность и права организации зависят от тарифного плана Claude. См. актуальные инструкции Anthropic.

Claude Code

Менеджер выводит готовую к запуску команду:

claude mcp add --transport http intervals-alex https://mcp.example.com/<secret>/mcp

ChatGPT

Добавьте сервер как пользовательское приложение/коннектор и используйте URL-адрес, принимаемый вашим текущим рабочим пространством ChatGPT. Доступность, интерфейс и требования администратора зависят от тарифного плана и могут меняться. См. актуальную документацию приложений OpenAI. Менеджер показывает оба формата URL-адресов для совместимости.

Другие клиенты

Используйте /mcp с удалёнными клиентами Streamable HTTP и /sse со старыми SSE-клиентами. Следуйте актуальной документации клиента и никогда не коммитьте секретный URL-адрес в общую конфигурацию.

Администрирование

Интерактивная панель — рекомендуемый интерфейс:

./manage.sh

Для автоматизации тот же интерфейс имеет подкоманды:

uv run intervals-mcp-admin add
uv run intervals-mcp-admin list
uv run intervals-mcp-admin show alex
uv run intervals-mcp-admin edit alex
uv run intervals-mcp-admin rotate alex
uv run intervals-mcp-admin remove alex

Избегайте --api-key в интерактивной оболочке, поскольку аргументы команд могут сохраняться в истории оболочки или быть видны в списке процессов. Опустите его для скрытого ввода.

Локальный режим stdio

Для одного спортсмена и клиента, запускающего локальные процессы, скопируйте .env.example в .env, настройте учётные данные Intervals.icu и запустите:

uv run intervals-mcp

Модель безопасности

• Запросы к Intervals.icu доступны только для чтения (GET).

• Каждый спортсмен получает отдельный API-клиент и независимый случайный токен пути.

• .env и users.toml находятся в .gitignore и записываются с правами 0600.

• API-ключи и токены пути исключаются из журналов доступа приложения и прокси.

• Публичная служба использует HTTPS через Caddy.

• users.toml монтируется в контейнер в режиме только для чтения.

Токен пути — это bearer-аутентификация: любой, у кого есть URL-адрес, может читать данные этого спортсмена. Смените его через ./manage.sh, если он был скомпрометирован. См. SECURITY.md для сообщения о проблемах.

Разработка

uv sync
uv run pytest

Тесты используют полностью синтетические фикстуры в формате API и не выполняют сетевых запросов. Перегенерируйте их с помощью uv run python scripts/generate_fixtures.py.

Рекомендации по разработке см. в CONTRIBUTING.md.

Лицензия

MIT — см. LICENSE.