Intervals.icu MCP-сервер

Сервер Model Context Protocol (MCP) для соединения Claude с API Intervals.icu. Он предоставляет инструменты для аутентификации и извлечения данных для действий, событий и данных о самочувствии.

Требования

Python 3.10 или выше
Модель контекстного протокола (MCP) Python SDK
httpx
python-dotenv

Настраивать

1. Установить УФ (рекомендуется)

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Клонировать этот репозиторий

git clone https://github.com/mvilanova/intervals-mcp-server.git
cd intervals-mcp-server

3. Создать и активировать виртуальную среду

# Create virtual environment with Python 3.12
uv venv --python 3.12

# Activate virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate

4. Синхронизация зависимостей проекта

uv sync

5. Настройте переменные среды

Создайте копию .env.example и назовите ее .env , выполнив следующую команду:

cp .env.example .env

Затем отредактируйте файл .env и укажите идентификатор спортсмена Intervals.icu и ключ API:

API_KEY=your_intervals_api_key_here
ATHLETE_ID=your_athlete_id_here

Получение ключа API Intervals.icu

Войдите в свою учетную запись Intervals.icu
Перейдите в Настройки > API.
Сгенерировать новый ключ API

Как найти свой идентификатор спортсмена

Ваш идентификатор спортсмена обычно виден в URL, когда вы вошли в Intervals.icu. Он выглядит так:

https://intervals.icu/athlete/i12345/... где i12345 — ваш идентификатор спортсмена

Использование

1. Настройте Claude Desktop

Чтобы использовать этот сервер с Claude Desktop, вам необходимо добавить его в конфигурацию Claude Desktop.

Для настройки Claude Desktop выполните следующую команду из каталога intervals_mcp_server :

mcp install src/intervals_mcp_server/server.py --name "Intervals.icu" --with-editable . --env-file .env

Если вы откроете файл конфигурации приложения Claude Desktop claude_desktop_config.json , он должен выглядеть следующим образом:

{
  "mcpServers": {
    "Intervals.icu": {
      "command": "/Users/<USERNAME>/.cargo/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with-editable",
        "/path/to/intervals-mcp-server",
        "mcp",
        "run",
        "/path/to/intervals-mcp-server/src/intervals_mcp_server/server.py"
      ],
      "env": {
        "INTERVALS_API_BASE_URL": "https://intervals.icu/api/v1",
        "ATHLETE_ID": "<YOUR_ATHLETE_ID>",
        "API_KEY": "<YOUR_API_KEY>",
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

Где /path/to/ — это путь к папке кода intervals-mcp-server в вашей системе.

Если вы наблюдаете следующие сообщения об ошибках при открытии Claude Desktop, включите полный путь к uv в командный ключ в файле конфигурации claude_desktop_config.json . Вы можете получить полный путь, запустив which uv в терминале.

2025-04-28T10:21:11.462Z [info] [Intervals.icu MCP Server] Initializing server...
2025-04-28T10:21:11.477Z [error] [Intervals.icu MCP Server] spawn uv ENOENT
2025-04-28T10:21:11.477Z [error] [Intervals.icu MCP Server] spawn uv ENOENT
2025-04-28T10:21:11.481Z [info] [Intervals.icu MCP Server] Server transport closed
2025-04-28T10:21:11.481Z [info] [Intervals.icu MCP Server] Client transport closed

Перезагрузите Claude Desktop.

2. Используйте сервер MCP с Клодом

После запуска сервера и настройки Claude Desktop вы можете использовать следующие инструменты, чтобы задавать вопросы о своих прошлых и будущих действиях, событиях и данных о здоровье.

get_activities : Получить список действий
get_activity_details : Получить подробную информацию о конкретном действии
get_activity_intervals : Получить подробные данные об интервалах для определенной активности
get_wellness_data : Извлечение данных о здоровье
get_events : Получить предстоящие события (тренировки, гонки и т. д.)
get_event_by_id : Получить подробную информацию о конкретном событии

Разработка и тестирование

Установите зависимости разработки и запустите тестовый набор с помощью:

uv sync --all-extras
pytest -v tests

Запуск сервера локально

Чтобы запустить сервер вручную (полезно при разработке или тестировании), выполните:

mcp run src/intervals_mcp_server/server.py

Лицензия

Стандартная общественная лицензия GNU v3.0

Избранное

Глама.ай

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Подключает Клода к API Intervals.icu для получения данных о фитнесе, включая занятия, тренировки, показатели здоровья и тренировочные мероприятия.

Related MCP Servers

Roam Research
2b3pro
A
security
A
license
A
quality
Provides comprehensive access to Roam Research's API functionality. This server enables AI assistants like Claude to interact with your Roam Research graph through a standardized interface.
Last updated -
18
25
38
TypeScript
MIT License
Iaptic MCP Serverofficial
iaptic
A
security
A
license
A
quality
A server for interacting with the Iaptic API, allowing AI models like Claude to query customer, purchase, and transaction data, as well as retrieve statistical insights.
Last updated -
16
4
TypeScript
MIT License
Claude Desktop API MCP
mlobo2012
A
security
F
license
A
quality
A server that enables Claude Desktop users to access the Claude API directly, allowing them to bypass Professional Plan limitations and use advanced features like custom system prompts and conversation management.
Last updated -
1
5
Python
Garmin MCP Server
Taxuspt
-
security
A
license
-
quality
Connects to Garmin Connect and exposes your fitness and health data (activities, sleep, heart rate, steps, body composition) to Claude and other MCP-compatible clients.
Last updated -
1
Python
MIT License

View all related MCP servers

Intervals.icu MCP Server