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.

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을 다시 시작합니다.

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Claude를 Intervals.icu API에 연결하여 활동, 운동, 웰빙 지표, 트레이닝 이벤트 등의 피트니스 데이터를 검색합니다.