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

Если сервер Model Context Protocol (MCP) вам полезен, пожалуйста, рассмотрите возможность поддержать его дальнейшее развитие пожертвованием.

Требования

• Python 3.12 или выше
• Python SDK Model Context Protocol (MCP)
• httpx
• Python-DotenV

Подготовка

1. Рекомендуется установить UV

macOS/Linux:

Windows (PowerShell):

После установки найдите полный путь к uv — он понадобится позже при настройке Claude Desktop:

2. Клонируйте этот репозиторий

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

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

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

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

macOS/Linux:

Windows (PowerShell):

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

Получение вашего Intervals.icu API Key

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

Поиск вашего спортивного ID

Intervals.icu MCP Server

Model Context Protocol (MCP) server for connecting Claude and ChatGPT with the Intervals.icu API. It provides tools for authentication and data retrieval for activities, events, wellness data, power curves, and custom items.

If you find the Model Context Protocol (MCP) server useful, please consider supporting its continued development with a donation.

Requirements

• Python 3.12 or higher
• Model Context Protocol (MCP) Python SDK
• httpx
• python-dotenv

Setup

1. Install uv (recommended)

macOS/Linux:

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

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

After installation, find the full path to uv — you’ll need it later when configuring Claude Desktop:

where.exe uv
# Example output: C:\Users\\.local\bin\uv.exe

2. Clone this repository

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

3. Create and activate a virtual environment

# 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. Sync project dependencies

uv sync

5. Set up environment variables

Make a copy of .env.example and name it .env by running the following command:

macOS/Linux:

cp .env.example .env

Windows (PowerShell):

Copy-Item .env.example .env

Then edit the .env file and set your Intervals.icu athlete id and API key:

API_KEY=your_intervals_api_key_here
ATHLETE_ID=your_athlete_id_here

Getting your Intervals.icu API Key

1. Log in to your Intervals.icu account
2. Go to Settings > API
3. Generate a new API key

Finding your Athlete ID

Your athlete ID is typically visible in the URL when you’re logged into Intervals.icu. It looks like:

• https://intervals.icu/athlete/i12345/... where i12345 is your athlete ID

Updating

This project is actively developed, with new features and fixes added regularly. To stay up to date, follow these steps:

1. Pull the latest changes from main

⚠️ Make sure you don’t have uncommitted changes before running this command.

macOS/Linux:

git checkout main && git pull

Windows (PowerShell):

git checkout main; git pull

2. Update Python dependencies

Activate your virtual environment and sync dependencies:

macOS/Linux:

source .venv/bin/activate
uv sync

Windows (PowerShell):

.venv\Scripts\activate
uv sync

Troubleshooting

If Claude Desktop fails due to configuration changes, follow these steps:

1. Delete the existing Intervals.icu entry in claude_desktop_config.json.