Claude와 ChatGPT를 Intervals.icu API와 연결하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 활동, 이벤트, 웰니스 데이터, 면곱 곡선, 맞춤 아이템에 대한 인증 및 데이터 검색 도구를 제공합니다.

모델 컨텍스트 프로토콜(MCP) 서버가 유용하다면, 지속적인 개발을 지원하여 기부를 고려해 주시기 바랍니다.

요구 사항

• Python 3.12 이상
• 모델 컨텍스트 프로토콜(MCP) 파이썬 SDK
• httpx
• 파이썬-dotenv

준비

1. UV 설치 (권장)

macOS/Linux:

Windows (PowerShell):

설치 후에는 uv로 가는 전체 경로를 찾으세요 — 나중에 Claude 데스크톱을 구성할 때 필요할 것입니다:

2. 이 저장소를 복제해

3. 가상 환경을 만들고 활성화하세요

4. 프로젝트 의존성 동기화

5. 환경 변수를 설정하세요

.env.example의 복사본을 만들고 다음 명령어를 실행하여 .env라고 이름 붙입니다:

macOS/Linux:

Windows (PowerShell):

그 다음 .env 파일을 편집하고 Intervals.icu 선수 ID와 API 키를 설정하세요:

Intervals.icu API 키를 받기

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.