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

Избранное

Глама.ай

Deploy Server

HTTP connection URL

A

security – no known vulnerabilities

-

license - not tested

A

quality - confirmed to work

How are these scores calculated?

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 Resources

Reddit Discussion about this server

Related MCP Servers

Garmin MCP Server
Taxuspt
-
security
-
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 -
95
MIT License
Education Data MCP Server
ckz
A
security
-
license
A
quality
Provides access to Urban Institute's Education Data API through Claude, enabling users to query and analyze detailed educational data from schools, districts, and universities.
Last updated -
2
2
MIT License
Webflow MCP Server
TimKJones
-
security
-
license
-
quality
Enables Claude to interact with Webflow's APIs, allowing access to site information, collections, and other Webflow resources.
Last updated -
193
MIT License
Qlik MCP Server
jwaxman19
-
security
-
license
-
quality
Enables Claude to interact with Qlik Cloud applications and extract data from visualizations through the Qlik Cloud API.
Last updated -
5
MIT License

View all related MCP servers

Intervals.icu MCP Server