hevy-mcp

Hevy 피트니스 앱 API를 위한 Python Model Context Protocol (MCP) 서버입니다. Claude(또는 MCP 호환 AI)에게 Hevy 운동 데이터에 대한 전체 액세스 권한을 부여하여 운동 기록, 루틴 관리, 신체 치수 추적 등을 수행할 수 있게 합니다.

기능

• Hevy API의 모든 엔드포인트를 다루는 25개의 도구

• 빌드 단계 없음 — 순수 Python으로, 설치 후 바로 실행 가능

• 전체 CRUD — 운동, 루틴, 운동 템플릿, 폴더, 신체 치수, 웹훅 생성, 읽기, 업데이트

도구

요구 사항

• Python 3.10 이상

• Hevy Pro 계정 (API 액세스에 필요)

• hevy.com/settings?developer에서 발급받은 API 키

설치

git clone https://github.com/YOUR_USERNAME/hevy-mcp
cd hevy-mcp
pip install -r requirements.txt

구성

Claude Desktop

claude_desktop_config.json에 추가하세요:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hevy": {
      "command": "python",
      "args": ["/absolute/path/to/hevy-mcp/server.py"],
      "env": {
        "HEVY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop을 재시작하세요. 채팅의 도구 아이콘 아래에 Hevy 서버가 나열된 것을 확인할 수 있습니다.

환경 변수

또는 환경에서 HEVY_API_KEY를 설정하고 직접 실행하세요:

export HEVY_API_KEY=your-api-key-here
python server.py

사용 예시

연결되면 Claude에게 다음과 같이 요청할 수 있습니다:

• "지난 5번의 운동을 보여줘"

• "오늘 한 가슴 운동을 기록해줘 — 벤치 프레스 100kg 3세트 8회, 인클라인 덤벨 30kg 3세트 10회"

• "Push/Pull/Legs 루틴을 만들어줘"

• "지난 한 달간의 체중 변화 추이는 어때?"

• "루마니안 데드리프트의 운동 템플릿 ID를 찾아줘"

• "지난 3개월 동안의 내 모든 벤치 프레스 세트를 보여줘"

기술 스택

• FastMCP — Python MCP 서버 프레임워크

• httpx — HTTP 클라이언트

• Hevy API — 공식 REST API

라이선스

MIT