Intervals MCP

러시아어 버전

AI 어시스턴트가 운동선수의 Intervals.icu 훈련 데이터에 접근할 수 있게 해주는 자체 호스팅 방식의 읽기 전용 MCP 서버입니다.

스포츠 워치, 자전거 컴퓨터, 트레이너, Strava 또는 기타 지원되는 소스를 Intervals.icu에 연결하세요. 그러면 Intervals MCP가 정규화된 훈련 데이터를 ChatGPT, Claude, Claude Code, Cursor, VS Code 및 기타 MCP 클라이언트에 제공합니다. 현재 지원되는 통합 목록은 Intervals.icu를 참조하세요. 통합 목록은 계속 추가되고 있습니다.

이 서버는 GET 요청만 수행합니다. 운동선수의 Intervals.icu 계정에서 어떤 것도 생성, 수정 또는 삭제할 수 없습니다.

어시스턴트가 읽을 수 있는 항목

• 운동선수 프로필, 시간대, 운동 설정, 존(FTP, LTHR, 최대 심박수).

• 활동, 상세 기록, 랩, 인터벌, 다운샘플링된 스트림.

• 웰니스, 피트니스, 피로도, HRV, 수면, 기분, 체중(사용 가능한 경우).

• 계획된 이벤트, 최고 기록 곡선, 장비, 운동 라이브러리.

• 읽기 전용 원시 도구를 통한 추가 Intervals.icu v1 GET 엔드포인트.

대용량 응답은 모델에 도달하기 전에 압축됩니다. 빈 필드는 생략되고, 스트림은 다운샘플링되며, 요약은 전체 데이터 시리즈를 사용합니다.

Related MCP server: intervals.mcp

빠른 시작

공개 호스트 이름을 가진 Ubuntu 또는 Debian VPS가 필요합니다. 호스트 이름의 DNS 레코드를 서버로 지정하고 인바운드 TCP 포트 80과 443을 허용하세요. 설치 프로그램이 Docker, Compose, Git, uv를 자동으로 추가합니다(없는 경우):

curl -fsSL https://raw.githubusercontent.com/VictorForV/intervals-mcp/master/install.sh | sudo bash

install.sh를 실행하기 전에 검토하세요. 원격 셸 스크립트를 권한 있는 셸로 파이프하는 것이 불편하다면, 저장소를 클론하고 ./manage.sh를 실행하여 수동으로 설치할 수도 있습니다.

초기 설정을 선택하세요. 관리자가 공개 호스트 이름, 짧은 운동선수 이름, Intervals.icu 운동선수 ID와 API 키를 요청합니다. ID와 키는 Intervals.icu의 설정 → 개발자 설정에서 확인할 수 있습니다. API 키는 숨김 입력으로 처리됩니다.

관리자가 소유자 전용 설정을 만들고, 강력한 무작위 URL 토큰을 생성하고, 서비스를 시작한 후 커넥터 URL을 출력합니다. 나중에 ./manage.sh를 실행하여 운동선수를 추가, 편집 또는 제거하고, URL을 교체하고, 재빌드하고, 재시작하거나 서비스를 점검할 수 있습니다.

AI 클라이언트 연결

각 운동선수는 두 개의 비밀 URL을 받습니다:

https://mcp.example.com/<secret>/mcp  # Streamable HTTP, preferred
https://mcp.example.com/<secret>/sse  # legacy SSE compatibility

전체 URL을 비밀번호처럼 취급하세요. 이 URL은 해당 운동선수의 훈련 및 웰니스 데이터에 대한 읽기 권한을 부여합니다.

Claude 및 Claude Desktop

설정 → 커넥터 → 사용자 지정 커넥터 추가를 열고 /mcp URL을 입력하세요. 가용성과 조직 권한은 Claude 요금제에 따라 다릅니다. 현재 Anthropic 안내서를 참조하세요.

Claude Code

관리자가 바로 실행 가능한 명령을 출력합니다:

claude mcp add --transport http intervals-alex https://mcp.example.com/<secret>/mcp

ChatGPT

서버를 사용자 지정 앱/커넥터로 추가하고 현재 ChatGPT 워크스페이스에서 허용되는 URL을 사용하세요. 가용성, UI 및 관리자 요구 사항은 요금제에 따라 다르며 변경될 수 있습니다. 현재 OpenAI 앱 문서를 참조하세요. 관리자는 호환성을 위해 두 URL 형식을 모두 표시합니다.

기타 클라이언트

원격 Streamable HTTP 클라이언트에는 /mcp을, 구형 SSE 클라이언트에는 /sse를 사용하세요. 클라이언트의 현재 문서를 따르고 비밀 URL을 공유 설정에 절대 커밋하지 마세요.

관리

대화형 패널이 권장 인터페이스입니다:

./manage.sh

자동화를 위해 동일한 인터페이스에 하위 명령이 있습니다:

uv run intervals-mcp-admin add
uv run intervals-mcp-admin list
uv run intervals-mcp-admin show alex
uv run intervals-mcp-admin edit alex
uv run intervals-mcp-admin rotate alex
uv run intervals-mcp-admin remove alex

대화형 셸에서 --api-key 사용은 피하세요. 명령 인수가 셸 기록이나 프로세스 목록에 저장될 수 있기 때문입니다. 숨김 입력을 위해 생략하세요.

로컬 stdio 모드

로컬 프로세스를 실행하는 클라이언트용 단일 운동선수 설정의 경우, .env.example을 .env로 복사하고 Intervals.icu 자격 증명을 구성한 후 다음을 실행하세요:

uv run intervals-mcp

보안 모델

• Intervals.icu 요청은 읽기 전용(GET)입니다.

• 각 운동선수는 별도의 API 클라이언트와 독립적인 무작위 경로 토큰을 받습니다.

• .env와 users.toml은 gitignore에 포함되며 0600 권한으로 작성됩니다.

• API 키와 경로 토큰은 애플리케이션 및 프록시 액세스 로그에서 제외됩니다.

• 공개 서비스는 HTTPS를 통해 Caddy를 사용합니다.

• users.toml은 컨테이너에 읽기 전용으로 마운트됩니다.

경로 토큰은 Bearer 인증입니다. URL을 가진 사람은 누구나 해당 운동선수의 데이터를 읽을 수 있습니다. 노출된 경우 ./manage.sh에서 교체하세요. 취약점 보고는 SECURITY.md를 참조하세요.

개발

uv sync
uv run pytest

테스트는 완전히 합성된 API 픽스처를 사용하며 네트워크 요청을 수행하지 않습니다. uv run python scripts/generate_fixtures.py로 픽스처를 다시 생성하세요.

기여 지침은 CONTRIBUTING.md를 참조하세요.

라이선스

MIT — LICENSE 참조.