Hevy MCP Server

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

什么是MCP？

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

可用工具

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

• get-workouts：获取指定开始和结束日期之间的锻炼。按日期降序返回锻炼，包括持续时间和体积统计数据。最多返回10个锻炼。
• get-exercise-progress-by-ids：跟踪特定锻炼随时间的进度，按日期范围过滤。也返回每组的记录。
• get-exercises：获取全面的锻炼数据，按使用频率排序，可选地按名称和日期范围过滤。也返回实际和估计的1RM。
• get-routines：检索您保存的锻炼计划。

锻炼提示生成器

该服务器包含一个智能锻炼提示生成器，它：

• 分析您最常使用的锻炼及其估计的1RM
• 列出您的保存锻炼计划，附带详细的锻炼信息
• 帮助AI助手根据您的历史记录创建个性化的锻炼建议

资源文档

该服务器通过专用资源端点提供所有可用工具及其参数的详细文档。这些文档包括：

• 参数的详细描述
• 参数的有效范围和默认值
• 示例使用场景

获取您的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进行自动化版本管理和包发布。我们遵循常规提交规范编写提交消息。