适合谁
- Hevy PRO 用户
- 希望用 AI 助手分析训练数据和规划锻炼的健身爱好者
- 需要在多个 MCP 客户端（如 Claude Desktop、Codex、Cursor）中集成 Hevy 数据的开发者
H
66FMRS · C
Hevy MCP Server 是一个功能丰富的 MCP 服务器，提供 26 个工具用于管理 Hevy 数据，支持本地 stdio 和托管 Streamable HTTP 两种模式。它适合需要 AI 辅助训练分析的高级用户，但要求 Hevy PRO 订阅，且不是官方产品。安全方面需要注意 API 密钥保护和遥测隐私。
Hevy MCP Server 是一个开源的 Model Context Protocol (MCP) 服务器，用于 Hevy 健身与训练追踪应用。它允许 AI 助手通过身份验证的 Hevy API 请求来读取、分析、创建和更新你的 Hevy 锻炼、训练计划、动作模板和身体测量数据。支持多步工作流、提示词和多种工具，可进行训练分析、动作搜索和计划管理。
工具能力
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 中创建 API 密钥（需要 Hevy PRO）。
- 本地安装：在 MCP 客户端配置中添加
npx -y hevy-mcp，并设置环境变量HEVY_API_KEY。 - 或使用托管端点：将
https://mcp.hevy-mcp.dev/mcp作为 Streamable HTTP URL，并在请求头中携带Authorization: Bearer <HEVY_API_KEY>。 - 重启或重新连接客户端，然后询问第一个问题。
claude_desktop_config.json
{
"mcpServers": {
"hevy": {
"command": "npx",
"args": [
"-y",
"hevy-mcp"
],
"env": {
"HEVY_API_KEY": "your-hevy-api-key"
}
}
}
}
选型与风险
不适合谁
- 没有 Hevy PRO 订阅的用户
- 需要删除功能的用户（Hevy API 不提供删除端点）
- 寻找官方支持的用户（此服务器由社区维护，非 Hevy 官方）
所需权限
- 需要 Hevy API 密钥（`HEVY_API_KEY`）
- 能够读取和写入 Hevy 数据（锻炼、计划、动作模板、身体测量等）
- 托管端点会向 Hevy 发送 API 密钥，并在每个请求中验证
风险与副作用
- API 密钥泄露风险：密钥不应出现在源代码、URL、日志或截图中。
- 误操作风险：创建操作在重试时可能产生重复数据；更新操作会替换现有记录。
- 数据隐私：本地包默认启用遥测（可禁用），可能发送错误和指标到外部服务。
- 依赖第三方服务：托管端点依赖 Cloudflare Worker，存在可用性风险。
- 库存路由：请求可能需要确认，但客户端支持程度不同。
常见排障
- 如果服务器没有出现，请重启或重新连接 MCP 客户端。
- 如果 `npx` 失败，确保 Node.js 20 或更高版本已安装，然后运行 `npx -y hevy-mcp --version`。
- 如果 Codex 看不到服务器，运行 `codex mcp list`，确认 'hevy' 条目后开始新会话。
- 如果托管认证失败，确认密钥有效、属于 Hevy PRO 账户，并且作为 `Authorization: Bearer <HEVY_API_KEY>` 发送。
- 如果需要诊断，设置 `HEVY_MCP_DEBUG=1`，诊断输出到 stderr，不会影响 MCP 消息。
- 如果本地认证失败，确认密钥有效并在子进程环境中作为 `HEVY_API_KEY` 可用。
使用场景
分析最近几周的训练进度、频率、动作分布和身体测量趋势。
用自然语言查询最近的锻炼、常用动作、计划详情或动作历史。
创建或更新锻炼、训练计划、文件夹、自定义动作和身体测量记录。
搜索动作模板和训练计划，获取简洁、适合 AI 的结果。
支持客户端
Claude Desktop完整支持
Codex完整支持
Cursor完整支持
Google Antigravity完整支持