🚀 希弗 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。