🚀 希弗 MCP 服务器

希弗 MCP 服务器是一个用 TypeScript 和 Node.js 编写的服务器，它借助模型上下文协议（MCP），将希弗（Hevy）健身数据与语言模型连接起来。通过该服务器，可从希弗 API 获取数据，还能使用相关工具访问锻炼历史、锻炼进展和最佳记录，为健身数据的分析和利用提供便利。

🚀 快速开始

获取希弗 API 密钥

要获取您的希弗 API 密钥，请访问 Hevy API 文档 并按照身份验证说明操作。您需要通过希弗开发者门户网站注册以获取 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 替换为您的实际希弗 API 密钥。

✨ 主要特性

连接健身数据与语言模型

将希弗健身数据与语言模型通过模型上下文协议（MCP）连接，让 AI 助手能够访问并分析您的希弗健身数据。

丰富的可用工具

此 MCP 服务器提供了多种实用工具：

• get-workouts：获取指定开始和结束日期之间的锻炼记录。返回按日期降序排列的锻炼，带有持续时间和总量统计信息，最多显示10条记录。
• get-exercise-progress-by-ids：跟踪特定锻炼在一段时间内的进展，还包括每组的最大值记录。
• get-exercises：获取全面的锻炼数据，默认按使用频率排序，可选过滤器包括名称和日期范围，还包括实际和估计的一次性最大力量（1RM）。
• get-routines：检索您的保存训练计划。

智能锻炼提示构建器

服务器包含的智能锻炼提示构建器可：

• 分析您最常使用的锻炼及其估算的一次性最大力量。
• 列出详细的锻炼信息和您的保存训练计划。
• 帮助 AI 助手根据您的历史记录创建个性化的锻炼建议。

详细的资源文档

服务器提供所有可用工具的详细文档，可通过专门的资源端点访问。此文档包括详细参数描述、参数的有效范围和默认值以及示例用法场景。

📚 详细文档

什么是 MCP？

模型上下文协议（MCP）是一项标准，允许像 claude 这样的大型语言模型（LLMs）与外部数据源和工具集成。此 MCP 服务器使 AI 助手能够访问并分析您的希弗健身数据。

资源文档

服务器提供所有可用工具的详细文档，可通过专门的资源端点访问。此文档包括：

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

获取您的希弗 API 密钥

要获取您的希弗 API 密钥，请访问 Hevy API 文档 并按照身份验证说明操作。您需要通过希弗开发者门户网站注册以获取 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 替换为您的实际希弗 API 密钥。

🔧 技术细节

发布流程

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

技术文档

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