Whoop MCP 서버

Python 패키지 라이센스: MIT Python 3.12

Whoop API에 대한 액세스를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 언어 모델이 Whoop API에서 사이클, 회복, 긴장, 운동 데이터를 쿼리할 수 있도록 지원합니다.

사용 가능한 도구

서버는 다음 도구를 제공합니다.

사이클 쿼리

get_cycle_collection(start_date: str, end_date: str) : 특정 날짜 범위에 대한 주기 데이터를 가져옵니다.
get_latest_cycle() : 가장 최근의 사이클 데이터를 가져옵니다.

회복과 긴장

get_recovery_data(start_date: str, end_date: str) : 특정 날짜 범위에 대한 복구 데이터를 가져옵니다.
get_strain_data(start_date: str, end_date: str) : 특정 날짜 범위에 대한 변형률 데이터를 가져옵니다.
get_average_strain(days: int = 7) : 지정된 일수 동안의 평균 변형률을 계산합니다.

프로필 및 인증

get_profile() : 사용자 프로필 정보를 가져옵니다
check_auth_status() : Whoop API를 사용하여 인증 상태 확인

날짜는 ISO 형식(YYYY-MM-DD)으로 제공해야 합니다.

Related MCP server: Strava MCP Server

용법

이 서버를 사용하려면 Whoop 자격 증명이 필요합니다. 이 서버는 Whoop API를 통해 이메일/비밀번호 인증을 사용합니다.

데스크톱용 클로드

macOS에서는 ~/Library/Application\ Support/Claude/claude_desktop_config.json , Windows에서는 %APPDATA%/Claude/claude_desktop_config.json 에 있는 claude_desktop_config.json 업데이트하여 다음을 포함하세요.

지엑스피1

HTTP API 서버

이 프로젝트에는 HTTP 엔드포인트를 통해 동일한 기능을 제공하는 HTTP API 서버도 포함되어 있습니다. 실행 방법은 다음과 같습니다.

./run_whoop_server.sh

예제 쿼리

연결되면 Claude에게 다음과 같은 질문을 할 수 있습니다.

"오늘 내 회복 점수는 얼마예요?"
"지난주 내 균주 데이터를 보여주세요"
"지난 7일 동안 내 평균 균주는 무엇입니까?"
"내 최신 사이클 데이터 가져오기"

오류 처리

서버는 일반적인 문제에 대해 사람이 읽을 수 있는 오류 메시지를 제공합니다.

잘못된 날짜 형식
API 인증 오류
네트워크 연결 문제
자격 증명이 누락되었거나 유효하지 않습니다.

프로젝트 구조

whoop/
├── src/
│   ├── whoop_server.py      # MCP server implementation
│   └── whoop_http_server.py # HTTP API server implementation
├── config/
│   └── .env                 # Environment variables
├── requirements.txt         # Python dependencies
└── run_whoop_server.sh     # Script to run HTTP server