适合谁
- Hevy PRO 用户希望 AI 助理直接读写其训练数据
- 喜欢使用 Claude、Cursor、Codex 等 MCP 客户端进行训练跟踪的人
- 需要从训练数据生成摘要和洞察的任何人
H
77FMRS · B
Hevy MCP Server 是一个专为 Hevy 健身应用设计的非官方 MCP 服务器。它提供 26 个工具，用于管理训练、日常计划、动作模板和身体测量数据，并需要 Hevy API 密钥（需要 Hevy PRO）。它支持多种 MCP 客户端，可通过 npm 或 Docker 在本地运行，并可通过 Cloudflare Worker 托管的 HTTP 端点用于远程访问。
Hevy MCP Server 是一个开源 Model Context Protocol (MCP) 服务器，用于 Hevy 健身与训练追踪应用。它使 AI 助手能够通过经过身份验证的 Hevy API 请求读取、分析、创建和更新您的 Hevy 训练、日常计划、动作模板和身体测量数据。该服务器通过 npm 包以 stdio 方式运行，需要 Hevy API 密钥（需要 Hevy PRO 订阅）。它注册 26 个工具、4 个资源和 2 个引导提示。
工具能力
get-training-summary
在一次调用中总结 1-12 周的训练活动和身体测量趋势。
get-workouts
从最新到最旧列出训练，包含动作和计时详情。
get-workout
按 ID 获取单个训练的完整详情。
get-workout-count
返回账户的总训练次数。
get-workout-events
列出自某个时间戳以来的训练更新和删除事件。
create-workout
在 Hevy 中创建已完成的训练。
update-workout
按 ID 修补训练元数据；未提供的字段和所有动作保持不变。
replace-workout-exercises
替换所有动作和组数，同时保留训练元数据。
search-routines
搜索日常计划标题并返回用于发现的紧凑元数据。
get-routines
列出自定义和默认训练日常计划。
get-routine
按 ID 获取一个日常计划及其动作配置。
create-routine
创建可重用的训练日常计划。
update-routine
替换现有日常计划的内容。
get-routine-folders
列出默认和自定义日常计划文件夹。
get-routine-folder
按 ID 获取一个日常计划文件夹的元数据。
create-routine-folder
创建日常计划文件夹。
get-exercise-templates
列出带有器械和肌肉元数据的动作模板。
get-exercise-template
按 ID 获取一个动作模板的完整元数据。
search-exercise-templates
按标题子字符串搜索完整动作目录。
create-exercise-template
创建自定义动作模板。
get-exercise-history
获取一个动作模板过去执行的组数。
get-body-measurements
列出带日期的身体测量数据。
get-body-measurement
获取某个日期的身体测量条目。
create-body-measurement
创建带日期的身体测量数据。
update-body-measurement
更新现有日期的身体测量数据。
get-user-info
返回用户的 ID、显示名称和公开个人资料 URL。
安装接入
- 在 Hevy 应用中获取 Hevy API 密钥（需要 Hevy PRO）。2. 使用 npx 配置 MCP 客户端：'npx -y hevy-mcp'，并设置环境变量 HEVY_API_KEY。或者使用 Docker：'docker run -i --rm -e HEVY_API_KEY ghcr.io/chrisdoc/hevy-mcp:latest'。3. 将提供的 JSON 配置添加到客户端的 mcpServers 配置中。4. 重启或重新连接您的 MCP 客户端。
claude_desktop_config.json
{
"mcpServers": {
"hevy": {
"command": "npx",
"args": [
"-y",
"hevy-mcp"
],
"env": {
"HEVY_API_KEY": "your-hevy-api-key"
}
}
}
}
选型与风险
不适合谁
- 没有 Hevy PRO 订阅的用户（API 密钥需要）
- 希望无需 API 密钥即可使用的用户
- 需要删除工作流的人（Hevy API 不提供删除端点）
所需权限
- 需要 HEVY_API_KEY 环境变量以进行 Hevy API 认证
- 可通过工具创建、更新和替换训练、日常计划、文件夹、模板和身体测量数据
- 读取操作可获取训练、日常计划、文件夹、模板、历史和用户信息
风险与副作用
- API 密钥如果泄露可能被滥用；不要在 URL、日志或截图等中暴露
- 创建操作在重试时可能产生重复项；更新操作会替换现有记录
- 该服务器将数据发送到 Hevy API，并可能将遥测数据发送到外部服务（除非禁用）
常见排障
- 确保 Node.js 20 或更高版本已安装
- 确认 HEVY_API_KEY 已正确设置为环境变量
- 重启或重新连接 MCP 客户端（配置更改后）
- 检查 API 密钥是否有效且属于 Hevy PRO 账户
使用场景
分析训练进度：总结 1-12 周的训练和身体测量数据。
用自然语言提问：查找最近的训练、经常训练的动作、一致性差距、日常计划详情或动作历史。
规划并记录训练：创建或更新训练、日常计划、文件夹、自定义动作和身体测量数据。
搜索而不产生巨大响应：发现日常计划和动作模板，结果紧凑且 AI 友好。
支持客户端
Claude Desktop完整支持
Cursor完整支持
Codex完整支持
Google Antigravity完整支持