Hevy MCP

🚀 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