hevy-mcp

Hevy MCP Server는 Hevy 피트니스 및 운동 추적 앱을 위한 오픈소스 Model Context Protocol(MCP) 서버입니다. 이를 통해 AI 어시스턴트는 인증된 Hevy API 요청을 통해 Hevy 운동, 루틴, 운동 템플릿, 신체 측정값을 읽고, 분석하고, 생성하고, 업데이트할 수 있습니다. Hevy PRO에서 제공되는 Hevy API 키가 필요합니다. 이 서버는 트레이닝 분석, 운동, 루틴, 루틴 폴더, 운동 템플릿, 운동 이력, 신체 측정값, 진단을 포함한 범주에 걸쳐 23개의 도구를 등록합니다. 읽기 전용 도구는 탐색을 지원하며, 생성 및 업데이트 도구는 MCP 변경(mutation) 애너테이션과 함께 노출되어 호환 클라이언트가 확인을 요청할 수 있습니다. 현재 Hevy API는 삭제 엔드포인트를 제공하지 않으므로 삭제 도구는 제공되지 않습니다. 사용자는 https://mcp.hevy-mcp.dev/mcp에 있는 호스팅된 Cloudflare Streamable HTTP 엔드포인트를 통해 연결할 수 있으며, 이 경우 Hevy API 키를 베어러 토큰으로 전송해야 합니다. 또는 npx, bunx, Docker를 통해 로컬에서 실행할 수도 있습니다. 호스팅된 엔드포인트는 고정 헤더를 전송할 수 없는 Claude.ai 같은 클라이언트를 위해 OAuth 2.1을 지원합니다. 별도의 CLI 패키지인 @chrisdoc/hevy-cli는 운동, 루틴, 운동 종목, 신체 측정값에 대한 터미널 접근을 제공합니다. 이 저장소는 Hevy 클라이언트, 도메인 작업, MCP 코어, Node.js stdio 어댑터, Cloudflare Worker 어댑터, 독립 실행형 CLI를 위한 패키지로 구성된 워크스페이스로 조직되어 있습니다. 공개 HevyClient는 Promise 기반이며, 내부 작업은 재시도 일정, 타임아웃, 중단 처리를 위해 Effect를 사용합니다. 도구 입력 및 응답 계약은 Zod 스키마를 사용합니다.