# Futureweb Intervals MCP

MCP-сервер Futureweb Intervals MCP для анализа тренировочных данных из Intervals.icu: активности, кастомные поля, пульс, мощность, восстановление, сравнение плана и факта.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 14 у репозитория
- Автор: futureweb
- Лицензия: GPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/futureweb/intervals-mcp-server
- Обновлён: 2026-10-21
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/futureweb-intervals-mcp

## Что делает

Сервер читает данные из Intervals.icu и даёт агенту инструменты для разбора тренировок: активности со всеми кастомными полями и потоками (мощность, пульс, каденс, высота), интервалы, показатели самочувствия относительно персональных базовых значений, пороги и зоны, сравнение запланированных и выполненных тренировок, подъёмы, лучшие результаты, эффективность мощность-пульс, сопротивление усталости, питание и вес, недельные и месячные сводки.

Потоки отдаются в полном разрешении в CSV или JSON, с нарезкой по индексу или времени, статистика по каждому интервалу. Есть готовые промпты для тренерского анализа, вывод компактный или подробный на выбор (`detail_level`). Работает с данными из Garmin через companion-проект Garmin Intervals Bridge, но и без него функционален. По умолчанию доступно только чтение; запись, удаление и админские операции включаются через переменные окружения `MCP_PERMISSIONS` и `MCP_TOOLSET`.

Запускается локально или удалённо со встроенным OAuth 2.1 сервером и страницей разрешений для каждого подключения. Нужны API_KEY и ATHLETE_ID из Intervals.icu, Python 3.12+.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `API_KEY`, `ATHLETE_ID`, `MCP_PERMISSIONS`, `MCP_TOOLSET`, `ATHLETE_TIMEZONE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env API_KEY=<API_KEY> --env ATHLETE_ID=<ATHLETE_ID> --env MCP_PERMISSIONS=<MCP_PERMISSIONS> --env MCP_TOOLSET=<MCP_TOOLSET> --env ATHLETE_TIMEZONE=<ATHLETE_TIMEZONE> --transport stdio futureweb-intervals-mcp -- uvx futureweb-intervals-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from futureweb-intervals-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add futureweb-intervals-mcp --env API_KEY=<API_KEY> --env ATHLETE_ID=<ATHLETE_ID> --env MCP_PERMISSIONS=<MCP_PERMISSIONS> --env MCP_TOOLSET=<MCP_TOOLSET> --env ATHLETE_TIMEZONE=<ATHLETE_TIMEZONE> -- uvx futureweb-intervals-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from futureweb-intervals-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "futureweb-intervals-mcp": {
            "command": "uvx",
            "args": [
                "futureweb-intervals-mcp"
            ],
            "env": {
                "API_KEY": "<API_KEY>",
                "ATHLETE_ID": "<ATHLETE_ID>",
                "MCP_PERMISSIONS": "<MCP_PERMISSIONS>",
                "MCP_TOOLSET": "<MCP_TOOLSET>",
                "ATHLETE_TIMEZONE": "<ATHLETE_TIMEZONE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from futureweb-intervals-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "futureweb-intervals-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "futureweb-intervals-mcp"
            ],
            "env": {
                "API_KEY": "<API_KEY>",
                "ATHLETE_ID": "<ATHLETE_ID>",
                "MCP_PERMISSIONS": "<MCP_PERMISSIONS>",
                "MCP_TOOLSET": "<MCP_TOOLSET>",
                "ATHLETE_TIMEZONE": "<ATHLETE_TIMEZONE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from futureweb-intervals-mcp <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e API_KEY=<API_KEY> -e ATHLETE_ID=<ATHLETE_ID> -e MCP_PERMISSIONS=<MCP_PERMISSIONS> -e MCP_TOOLSET=<MCP_TOOLSET> -e ATHLETE_TIMEZONE=<ATHLETE_TIMEZONE> futureweb-intervals-mcp uvx futureweb-intervals-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from futureweb-intervals-mcp <команда>

## Когда брать
- проанализировать выполненную тренировку и сравнить с планом
- посмотреть динамику показателей самочувствия и восстановления за 42 дня
- найти похожие интервалы и проследить прогресс в повторяющихся тренировках
- проверить эффективность мощность-пульс и сопротивление усталости
- получить недельную или месячную сводку нагрузки и интенсивности

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
