Hevy MCP 服务器

一个 TypeScript Node.js 服务器，通过模型上下文协议 (MCP) 将您的 Hevy 锻炼数据连接到语言模型。 该服务器从 Hevy API 获取数据，并提供访问您的锻炼历史记录、运动进度和个人记录的工具。

什么是 MCP？

模型上下文协议 (MCP) 是一种标准，允许像 Claude 这样的 LLM 与外部数据源和工具集成。 此 MCP 服务器使 AI 助手能够访问和分析您的 Hevy 锻炼数据。

可用工具

此 MCP 服务器提供以下工具：

• get-workouts: 获取开始日期和结束日期之间的锻炼数据。 以日期降序返回锻炼数据，包含持续时间和运动量统计信息。 最多 10 个锻炼数据。
• get-exercise-progress-by-ids: 跟踪特定运动随时间的进度，按日期范围过滤。 还会返回每次重复的记录。
• get-exercises: 获取按使用频率排序的综合运动数据，可以选择按名称和日期范围进行过滤。 还会返回实际和估计的 1RM（一次最大重复重量）。
• get-routines: 检索您保存的锻炼计划

获取您的 Hevy API 密钥

要获取您的 Hevy API 密钥，请访问 Hevy API 文档 并按照身份验证说明进行操作。 您需要通过 Hevy 开发者门户注册以获取 API 访问权限。

添加到 Cursor

要将此 MCP 服务器添加到 Cursor，请使用以下配置更新您的 ~/.cursor/mcp.json 文件：

"hevy-mcp-server": {
  "command": "npx",
  "args": ["-y", "@vreippainen/hevy-mcp-server", "--stdio"],
  "env": {
    "HEVY_API_KEY": "your-api-key-here"
  }
}

将 your-api-key-here 替换为您实际的 Hevy API 密钥。

技术文档

有关安装、配置、运行服务器、API 端点、服务方法和项目结构的详细技术信息，请参阅 TECHNICAL.md。

发布流程

本项目使用 semantic-release 进行自动版本控制和软件包发布。 我们遵循 Conventional Commits 规范来编写提交消息。