Minimal Hevy MCP

작은 로컬 Model Context Protocol 서버로, 에이전트가 Hevy의 공개 API를 통해 Hevy 운동 데이터를 읽고 운동 루틴을 만들 수 있게 합니다.

포함된 도구

• hevy_list_workouts

• hevy_get_workout

• hevy_list_routines

• hevy_get_routine

• hevy_search_exercises

• hevy_get_exercise_history

• hevy_create_workout

• hevy_create_routine

처음 여섯 도구는 읽기 전용입니다. hevy_create_workout과 hevy_create_routine은 연결된 Hevy 계정에 쓰기 작업을 하며 비멱등(non-idempotent) 뮤테이션으로 주석 처리되어 있습니다.

hevy_create_routine은 향후 세션을 위한 재사용 가능한 계획을 생성합니다. hevy_create_workout은 실제 시작/종료 시간과 세트 결과를 사용하여 이미 완료된 세션을 기록합니다. 완료된 운동은 기본적으로 비공개로 설정되며, 기록된 성과 지표가 없는 세트는 거부합니다.

Related MCP server: hevy-mcp-server

요구 사항

• Node.js 20 이상

• Hevy Pro 계정 및 https://hevy.com/settings?developer에서 발급받은 API 키

설치 및 검증

npm install
npm run check
npm run build
npm run smoke

로컬에서 실행

export HEVY_API_KEY="your-key"
npm start

이 서버는 stdin/stdout으로 통신하므로 직접 실행하면 조용히 대기하는 것처럼 보입니다. MCP 호스트가 이 서버를 시작하고 통신할 것으로 기대됩니다.

Codex에 추가

먼저 서버를 빌드하고, Codex를 시작하는 환경에서 HEVY_API_KEY를 사용할 수 있게 만든 다음 실행합니다:

codex mcp add hevy -- node /absolute/path/to/hevy-mcp/dist/index.js

서버를 추가한 후 Codex를 다시 시작하세요. 다음 명령으로 구성을 확인합니다:

codex mcp list

API 키를 커밋하거나 도구 인수로 전달하지 마세요. MCP는 HEVY_API_KEY에서만 이 키를 읽고 필수 api-key 헤더에 담아 Hevy에 보냅니다.

추천 첫 요청

최근 운동 다섯 번을 읽고 빈도, 운동 선택, 그리고 뚜렷한 진행 패턴을 요약해 주세요. 아무것도 만들거나 업데이트하지 마세요.

에이전트에게 루틴 생성을 요청할 때는 전체 루틴을 먼저 보여주고 hevy_create_routine을 호출하기 전에 승인을 받도록 하세요.

완료된 운동을 로깅할 때는 에이전트에게 실제 운동, 세트 결과, 시간을 알려주세요. 전체 운동을 보여주고 hevy_create_workout을 호출하기 전에 승인을 받도록 하세요. 에이전트가 완료된 결과를 임의로 만들어내는 일은 절대 있어서는 안 됩니다.