金大哥 - hevy-mcp MCP 详情

article

README

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

致谢

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

hevy-mcp