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)으로 제공해야 합니다.

용법

이 서버를 사용하려면 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 서버도 포함되어 있습니다. 실행 방법은 다음과 같습니다.

예제 쿼리

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

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

오류 처리

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

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

프로젝트 구조

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.