chrisdoc/hevy-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

528 stars 96 forks 质量 91 趋势 43MIT

Repository Install

管理你的重量训练、训练计划、文件夹和锻炼模板。更快地创建和更新训练，组织计划，搜索动作，快速构建锻炼方案。

概览

Hevy-mcp 将支持 MCP 的助理（如 Claude Desktop 和 Cursor）连接到 Heavy 健身 API。询问锻炼历史、分析进展、浏览训练计划和锻炼，或创建和更新 Hevy 数据，无需离开助理。需要一个 Hevy API 密钥，随 Hevy PRO 提供。当MCP客户端能启动命令时，使用本地stdio。托管可流式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 需要Bun。

概述（AI 翻译）

与Claude、Cursor、Codex及其他MCP客户端的重型锻炼数据对话。

连接托管的MCP ·使用Hevy CLI ·观看18秒演示 ·探索全部23个工具 ·文档

重重CLI

更喜欢终端？分开的 @chrisdoc/hevy-cli 该软件包直接读取锻炼、训练计划、锻炼和身体测量数据并且可以通过显式确认。不支持删除。

在脚本和管道的任何命令中添加 --json。CLI 是独立的重度API客户端，不是MCP封装器。参见 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

新手？先看 mcpskill.org 教程 →

配置

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