Hevy-MCP：与Hevy健身应用API接口的模型上下文协议（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。

致谢

• 模型上下文协议为MCP SDK
• Hevy 为他们的健身追踪平台和API