hevy-mcp: Hevy Fitness API를 위한 모델 컨텍스트 프로토콜 서버

Hevy 피트니스 추적 앱 및 해당 API 와 연동되는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버를 통해 AI 어시스턴트는 Hevy API를 통해 운동 데이터, 루틴, 운동 템플릿 등에 접근하고 관리할 수 있습니다(PRO 구독 필요).

특징

• 운동 관리 : 운동 가져오기, 만들기 및 업데이트

• 루틴 관리 : 운동 루틴에 접근하고 관리하세요

• 운동 템플릿 : 사용 가능한 운동 템플릿을 찾아보세요

• 폴더 구성 : 일상적인 폴더 관리

Related MCP server: AgentMode

필수 조건

• Node.js(v20 이상)

• npm 또는 yarn

• Hevy API 키

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 hevy-mcp를 자동으로 설치하려면:

지엑스피1

수동 설치

# Clone the repository
git clone https://github.com/chrisdoc/hevy-mcp.git
cd hevy-mcp

# Install dependencies
npm install

# Create .env file from sample
cp .env.sample .env
# Edit .env and add your Hevy API key

커서와의 통합

이 MCP 서버를 Cursor와 함께 사용하려면 다음 구성을 추가하여 ~/.cursor/mcp.json 파일을 업데이트해야 합니다.

{
  "hevy-mcp-server": {
    "command": "npx",
    "args": ["-y", "hevy-mcp"],
    "env": {
      "HEVY_API_KEY": "your-api-key-here"
    }
  }
}

your-api-key-here 실제 Hevy API 키로 바꿔야 합니다.

구성

프로젝트 루트에 다음 내용으로 .env 파일을 만듭니다.

HEVY_API_KEY=your_hevy_api_key_here

your_hevy_api_key_here 실제 Hevy API 키로 바꾸세요.

용법

개발

npm run dev

이렇게 하면 MCP 서버가 핫 리로딩을 사용하여 개발 모드로 시작됩니다.

생산

npm run build
npm start

사용 가능한 MCP 도구

서버는 다음 MCP 도구를 구현합니다.

운동 도구

• get-workouts : 운동 데이터 가져오기 및 포맷

• get-workout : ID로 단일 운동 가져오기

• create-workout : 새로운 운동을 만듭니다

• update-workout : 기존 운동 업데이트

• get-workout-count : 총 운동 횟수를 가져옵니다.

• get-workout-events : 운동 업데이트/삭제 이벤트 가져오기

일상 도구

• get-routines : 루틴 데이터 가져오기 및 포맷

• create-routine : 새로운 루틴을 생성합니다

• update-routine : 기존 루틴을 업데이트합니다.

• get-routine : ID로 단일 루틴 가져오기

운동 템플릿 도구

• get-exercise-templates : 운동 템플릿 가져오기

• get-exercise-template : ID로 템플릿 가져오기

일상적인 폴더 도구

• get-routine-folders : 루틴 폴더 가져오기

• create-routine-folder : 새 폴더 생성

• get-routine-folder : ID로 폴더 가져오기

프로젝트 구조

hevy-mcp/
├── .env                   # Environment variables (API keys)
├── src/
│   ├── index.ts           # Main entry point
│   ├── tools/             # Directory for MCP tool implementations
│   │   ├── workouts.ts    # Workout-related tools
│   │   ├── routines.ts    # Routine-related tools
│   │   ├── templates.ts   # Exercise template tools
│   │   └── folders.ts     # Routine folder tools
│   ├── generated/         # API client (generated code)
│   │   ├── client/        # Kiota-generated client
│   └── utils/             # Helper utilities
│       ├── formatters.ts  # Data formatting helpers
│       └── validators.ts  # Input validation helpers
├── scripts/               # Build and utility scripts
└── tests/                 # Test suite

개발

코드 스타일

이 프로젝트에서는 코드 포맷팅과 린팅에 Biome을 사용합니다.

npm run check

API 클라이언트 생성

API 클라이언트는 Kiota를 사용하여 OpenAPI 사양에서 생성됩니다.

npm run export-specs
npm run build:client

특허

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

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

감사의 말

• MCP SDK를 위한 모델 컨텍스트 프로토콜

• 피트니스 추적 플랫폼과 API를 제공하는 Hevy