Intervals.icu MCP 서버

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

요구 사항

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

설정

1. uv 설치 (권장)

지엑스피1

2. 이 저장소를 복제합니다.

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

3. 가상 환경 생성 및 활성화

# Create virtual environment
uv venv

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

4. 종속성 설치

uv pip install -e .

5. 환경 변수 설정

다음 명령을 실행하여 .env.example 의 복사본을 만들고 이름을 .env 로 지정합니다.

cp .env.example .env

그런 다음 .env 파일을 편집하여 Intervals.icu 선수 ID와 API 키를 설정합니다.

API_KEY=your_intervals_api_key_here
ATHLETE_ID=your_athlete_id_here

Intervals.icu API 키 받기

Intervals.icu 계정에 로그인하세요
설정 > API로 이동하세요
새로운 API 키 생성

선수 ID 찾기

Intervals.icu에 로그인하면 일반적으로 URL에 선수 ID가 표시됩니다. 다음과 같은 형태입니다.

https://intervals.icu/athlete/i12345/... 여기서 i12345 는 선수 ID입니다.

용법

1. Claude Desktop 구성

이 서버를 Claude Desktop과 함께 사용하려면 Claude Desktop 구성에 추가해야 합니다.

Claude Desktop을 구성하려면 intervals_mcp_server 디렉토리에서 다음을 실행하세요.

mcp install src/intervals_mcp_server/server.py --name "Intervals.icu MCP Server"

Claude Desktop App 구성 파일인 claude_desktop_config.json 열면 다음과 같이 표시됩니다.

{
  "mcpServers": {
    "Intervals.icu": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/path/to/intervals-mcp-server/src/intervals_mcp_server/server.py"
      ]
    }
  }
}

여기서 /path/to/ 시스템의 intervals-mcp-server 코드 폴더의 경로입니다.

Claude Desktop을 열 때 다음 오류 메시지가 나타나면 claude_desktop_config.json 구성 파일의 command 키에 uv 의 전체 경로를 포함하세요. 터미널에서 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. Claude와 함께 MCP 서버 사용

서버가 실행 중이고 Claude Desktop이 구성되면 다음 도구를 사용하여 과거 및 미래 활동, 이벤트, 웰빙 데이터에 대한 질문을 할 수 있습니다.

get_activities : 활동 목록을 검색합니다.
get_activity_details : 특정 활동에 대한 자세한 정보를 가져옵니다.
get_activity_intervals : 특정 활동에 대한 자세한 간격 데이터를 가져옵니다.
get_wellness_data : 웰니스 데이터 가져오기
get_events : 다가오는 이벤트(운동, 경주 등)를 검색합니다.
get_event_by_id : 특정 이벤트에 대한 자세한 정보를 가져옵니다.

특허

GNU 일반 공중 사용 허가서 v3.0

Intervals.icu MCP Server