使用说明
Hewy MCP服务器
一个TypeScript Node.js服务器，通过模型上下文协议（MCP）将您的Hevy训练数据连接到语言模型。服务器从Hevy API获取数据，并提供访问锻炼历史、锻炼进度和个人记录的工具。
什么是MCP？
模型上下文协议（MCP）是一种标准，允许像Claude这样的LLM与外部数据源和工具集成。此MCP服务器使AI助手能够访问和分析您的Hevy锻炼数据。
可用工具
此MCP服务器提供以下工具：
- 进行锻炼：在开始日期和结束日期之间进行锻炼。按日期降序返回训练，包括持续时间和训练量统计数据。最多10次训练。
- 通过ids获取运动进度：跟踪特定练习随时间的进展，按日期范围过滤。每次重复也会返回记录。
- 锻炼身体：获取按使用频率排序的综合锻炼数据，可选择按姓名和日期范围进行过滤。还包括实际和估计的1RM。
- 养成习惯：检索您保存的锻炼计划
训练提示生成器
该服务器包括一个智能锻炼提示生成器，该生成器：
- 分析你最常用的练习及其估计的1RM
- 列出您保存的锻炼计划和详细的锻炼信息
- 帮助AI助手根据您的历史记录创建个性化的锻炼建议
资源文档
服务器通过专用资源端点提供所有可用工具及其参数的全面文档。本文件包括：
- 详细参数说明
- 有效参数范围和默认值
- 示例使用场景
获取您的Hevy API密钥
要获取您的Hevy API密钥，请访问 Hevy API文档 并按照认证说明进行操作。您需要通过Hevy开发者门户注册API访问权限。
添加到光标
要将此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端点、服务方法和项目结构的详细技术信息，请参阅 技术.md.
