chrisdoc/hevy-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

528 stars 96 forks 품질 91 트렌드 43MIT

Repository Install

무거운 운동, 루틴, 폴더, 운동 템플릿을 관리하세요. 세션을 더 빠르게 생성하고 업데이트하며, 계획을 정리하고 운동을 검색해 빠르게 운동을 구성하세요.

개요

Hevy-mcP는 Claude Desktop과 Cursor와 같은 MCP 호환 어시스턴트를 Hevy 피트니스 API와 연결합니다. 운동 기록에 대해 문의하거나, 진행 상황을 분석하거나, 루틴과 운동을 탐색하거나, Assistant를 떠나지 않고도 Hevy 데이터를 생성하고 업데이트할 수 있습니다. Hevy PRO에서 제공되는 Hevy API 키가 필요합니다. MCP 클라이언트가 명령을 실행할 수 있을 때는 로컬 stdio를 사용하세요. 호스팅 가능한 Streamable HTTP 설정은 아래에 문서화되어 있지만 일시적으로 사용할 수 없습니다. npm 패키지와 공식 컨테이너는 MCP 실행 파일입니다. 클라이언트가 프로세스를 시작하고 표준 입출력을 통해 통신합니다; 이것은 인터랙티브 터미널 명령이나 HTTP 서비스가 아닙니다. 패키지 메타데이터에 명시된 Node.js 20 이상이 필요합니다. Claude Desktop(claude_desktop_config.json)과 Cursor(~/.cursor/mcp.json)는 모두 다음과 같은 mcpServers 항목을 받습니다: - ~/라이브러리/애플리케이션 지원/Claude/claude_desktop_config.json - %APPDATA%\Claude\claude_desktop_config.json 번이 필요해.

개요(AI 번역)

Claude, Cursor, Codex 및 기타 MCP 클라이언트의 헤비 운동 데이터와 대화하세요.

호스팅된 MCP에 접속하세요 · Hevy CLI 사용 · 18초 데모 시청 · 23가지 도구 모두 탐색 · 문서

헤비 CLI

터미널이 더 좋으신가요? 별도의 @chrisdoc/hevy-cli 패키지는 운동, 루틴, 운동, 신체 측정값을 직접 읽습니다 Hevy API에서 생성된 자원을 명시적으로 생성하거나 업데이트할 수 있습니다. 확인. 삭제는 지원되지 않습니다.

스크립트와 파이프라인에 대해 모든 명령어에 --json를 추가하세요. CLI는 독립 실행형입니다 MCP 래퍼가 아닌 무거운 API 클라이언트입니다. 참고하세요 packages/cli/README.md는 전체 지휘를 위해 참조, 페이지네이션 동작, 출구 코드.

hevy-mcp는 오픈 소스 모델 컨텍스트 프로토콜(MCP)입니다 헤비 피트니스 및 운동 추적 서버 앱. AI 비서가 당신의 무거운 운동을 읽고, 분석하고, 생성하고, 업데이트할 수 있게 해줍니다. 인증된 Hevy를 통한 루틴, 운동 템플릿, 신체 측정 API 요청.

Node stdio/HTTP 어댑터와 Cloudflare Worker는 동일한 MCP 도구를 공유합니다. 전송 수단을 선택하려면 배치 모드를 참조하세요. 작업 공간 소유권, 런타임 범위 아키텍처, 임베딩 API를 지원했습니다.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Hevy MCP Server

Hevy CLI

Prefer the terminal? The separate @chrisdoc/hevy-cli package reads workouts, routines, exercises, and body measurements directly from the Hevy API, and can create or update those resources with explicit confirmation. Deletion is not supported.

npm install -g @chrisdoc/hevy-cli
export HEVY_API_KEY=your-hevy-api-key

hevy workouts list --page-size 10
hevy summary --weeks 4

Add --json to any command for scripts and pipelines. The CLI is a standalone Hevy API client, not an MCP wrapper. See packages/cli/README.md for the full command reference, pagination behavior, and exit codes.

hevy-mcp is an open-source Model Context Protocol (MCP) server for the Hevy fitness and workout tracking app. It lets AI assistants read, analyze, create, and update your Hevy workouts, routines, exercise templates, and body measurements through authenticated Hevy API requests.

The Node stdio/HTTP adapter and Cloudflare Worker share the same MCP tools. See deployment modes to choose a transport, or architecture for workspace ownership, runtime scopes, and supported embedding APIs.

A Hevy API key, available with Hevy PRO, is required.

See it in action

GitHub에서 전체 README 보기

설치

npx -y hevy-mcp

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
	"mcpServers": {
		"hevy": {
			"url": "https://mcp.hevy-mcp.dev/mcp",
			"headers": {
				"Authorization": "Bearer your-hevy-api-key"
			}
		}
	}
}