🚀 Hevy-MCP：与Hevy健身应用API接口的模型上下文协议（MCP）服务器
Hevy-MCP是一个与Hevy健身追踪应用及其API接口的模型上下文协议（MCP）服务器实现。借助此服务器，AI助手能够通过Hevy API访问和管理训练数据、计划、锻炼模板等（需要PRO订阅），为健身数据的智能化管理提供了便利。
✨ 主要特性
- 训练管理：可以获取、创建和更新训练，方便用户对训练数据进行全面管理。
- 计划管理：支持访问并管理训练计划，让训练安排更加有序。
- 锻炼模板：能够浏览可用的锻炼模板，为用户提供多样化的锻炼选择。
- 文件夹组织：可对计划文件夹进行管理，使训练计划的分类更加清晰。
📦 安装指南
先决条件
- Node.js（v20或更高版本）
- npm 或 yarn
- Hevy API密钥
安装方式
通过Smithery安装
要自动使用Smithery为Claude Desktop安装hevy-mcp，可执行以下命令：
npx -y @smithery/cli install @chrisdoc/hevy-mcp --client claude
手动安装
# 克隆仓库
git clone https://github.com/chrisdoc/hevy-mcp.git
cd hevy-mcp
# 安装依赖项
npm install
# 从示例创建.env文件
cp .env.sample .env
# 编辑.env并添加您的Hevy API密钥
与Cursor的集成
要将此MCP服务器与Cursor一起使用，请更新~/.cursor/mcp.json文件，添加以下配置：
{
"hevy-mcp-server": {
"command": "npx",
"args": ["-y", "hevy-mcp"],
"env": {
"HEVY_API_KEY": "your-api-key-here"
}
}
}
请将your-api-key-here替换为您的实际Hevy API密钥。
🔧 配置
在项目根目录中创建一个.env文件，内容如下：
HEVY_API_KEY=your_hevy_api_key_here
将your_hevy_api_key_here替换为您的实际Hevy API密钥。
💻 使用示例
安装完成后
npm start # 启动服务器
功能模块
训练管理
- 获取所有训练
- 创建新训练
- 更新现有训练
- 删除训练
计划管理
- 获取所有计划
- 创建新计划
- 更新现有计划
- 删除计划
锻炼模板
- 获取所有锻炼模板
- 创建新锻炼模板
- 更新现有锻炼模板
- 删除锻炼模板
文件夹组织
- 创建文件夹
- 获取文件夹列表
- 更新文件夹结构
- 删除文件夹
项目结构
hevy-mcp/
├── src/
│ ├── index.js # 入口文件
│ ├── server.js # 服务器配置
│ └── routes/ # 路由模块
│ ├── workouts.js # 训练路由
│ ├── plans.js # 计划路由
│ └── templates.js # 锻炼模板路由
├── public/
│ └── .env # 环境变量文件
└── package.json # 依赖管理
📄 许可证
本项目根据MIT许可证发布，详细信息请参阅LICENSE文件。
贡献
欢迎贡献！请随时提交Pull Request。