Hevy MCP

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

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

특징

• 운동 관리 : 운동 가져오기, 만들기 및 업데이트
• 루틴 관리 : 운동 루틴에 접근하고 관리하세요
• 운동 템플릿 : 사용 가능한 운동 템플릿을 찾아보세요
• 폴더 구성 : 일상적인 폴더 관리

필수 조건

• Node.js(v20 이상)
• npm 또는 yarn
• Hevy API 키

설치

Smithery를 통해 설치

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

지엑스피1

수동 설치

커서와의 통합

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

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

구성

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

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

용법

개발

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

생산

사용 가능한 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로 폴더 가져오기

프로젝트 구조

개발

코드 스타일

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

API 클라이언트 생성

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

특허

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

기여하다

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

감사의 말

• MCP SDK를 위한 모델 컨텍스트 프로토콜
• 피트니스 추적 플랫폼과 API를 제공하는 Hevy