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

Name: Hevy MCP
Author: chrisdoc

라이센스: MIT 대장간 배지

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

One-click Deploy

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Hevy MCP