Minimal Hevy MCP

一个本地的小型 Model Context Protocol 服务器，能让智能体读取 Hevy 的锻炼数据，并通过 Hevy 的公开 API 创建训练计划。

包含的工具

• hevy_list_workouts

• hevy_get_workout

• hevy_list_routines

• hevy_get_routine

• hevy_search_exercises

• hevy_get_exercise_history

• hevy_create_workout

• hevy_create_routine

前六个工具是只读的。hevy_create_workout 和 hevy_create_routine 会写入所连接的 Hevy 账户，并被标记为非幂等变更操作。

hevy_create_routine 为未来的训练会话创建可复用的计划。hevy_create_workout 使用实际的开始/结束时间和每组的结果记录一次已完成的训练会话。它会把已完成的训练默认设为私密，并拒绝没有记录训练表现指标的组。

Related MCP server: hevy-mcp-server

要求

• Node.js 20 或更高版本

• 一个 Hevy Pro 账户，以及从 https://hevy.com/settings?developer 获取的 API 密钥

安装与验证

npm install
npm run check
npm run build
npm run smoke

本地运行

export HEVY_API_KEY="your-key"
npm start

该服务器通过 stdin/stdout 进行通信，所以直接运行时会显示为静默等待。它需要由一个 MCP 宿主机启动并与之通信。

添加到 Codex

先构建服务器，让 HEVY_API_KEY 对启动 Codex 的环境可用，然后运行：

codex mcp add hevy -- node /absolute/path/to/hevy-mcp/dist/index.js

添加服务器后重启 Codex。使用以下命令验证配置：

codex mcp list

不要提交 API 密钥，也不要将其作为工具参数传递。MCP 仅从 HEVY_API_KEY 中读取该密钥，并通过必需的 api-key 请求头将其发送给 Hevy。

建议的第一个请求

读取我最近的五次锻炼，总结锻炼频率、动作选择以及明显的进步规律。不要创建或更新任何内容。

当要求智能体创建训练计划时，应要求它先展示完整的训练计划，并在调用 hevy_create_routine 之前征得你的批准。

在记录一次已完成的锻炼时，应向智能体提供真实的训练动作、每组结果和训练时间。应要求它先展示完整的锻炼记录，并在调用 hevy_create_workout 之前征得你的批准。智能体绝不能编造已完成的结果。