Hevy MCP Server

🚀 希弗 MCP 服務器

希弗 MCP 服務器是一個用 TypeScript 和 Node.js 編寫的服務器，它藉助模型上下文協議（MCP），將希弗（Hevy）健身數據與語言模型連接起來。通過該服務器，可從希弗 API 獲取數據，還能使用相關工具訪問鍛鍊歷史、鍛鍊進展和最佳記錄，為健身數據的分析和利用提供便利。

🚀 快速開始

獲取希弗 API 密鑰

要獲取您的希弗 API 密鑰，請訪問 Hevy API 文檔 並按照身份驗證說明操作。您需要通過希弗開發者門戶網站註冊以獲取 API 訪問權限。

添加到 Cursor

要將此 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 替換為您的實際希弗 API 密鑰。

✨ 主要特性

連接健身數據與語言模型

將希弗健身數據與語言模型通過模型上下文協議（MCP）連接，讓 AI 助手能夠訪問並分析您的希弗健身數據。

豐富的可用工具

此 MCP 服務器提供了多種實用工具：

• get-workouts：獲取指定開始和結束日期之間的鍛鍊記錄。返回按日期降序排列的鍛鍊，帶有持續時間和總量統計信息，最多顯示10條記錄。
• get-exercise-progress-by-ids：跟蹤特定鍛鍊在一段時間內的進展，還包括每組的最大值記錄。
• get-exercises：獲取全面的鍛鍊數據，默認按使用頻率排序，可選過濾器包括名稱和日期範圍，還包括實際和估計的一次性最大力量（1RM）。
• get-routines：檢索您的保存訓練計劃。

智能鍛鍊提示構建器

服務器包含的智能鍛鍊提示構建器可：

• 分析您最常使用的鍛鍊及其估算的一次性最大力量。
• 列出詳細的鍛鍊信息和您的保存訓練計劃。
• 幫助 AI 助手根據您的歷史記錄創建個性化的鍛鍊建議。

詳細的資源文檔

服務器提供所有可用工具的詳細文檔，可通過專門的資源端點訪問。此文檔包括詳細參數描述、參數的有效範圍和默認值以及示例用法場景。

📚 詳細文檔

什麼是 MCP？

模型上下文協議（MCP）是一項標準，允許像 claude 這樣的大型語言模型（LLMs）與外部數據源和工具集成。此 MCP 服務器使 AI 助手能夠訪問並分析您的希弗健身數據。

資源文檔

服務器提供所有可用工具的詳細文檔，可通過專門的資源端點訪問。此文檔包括：

• 詳細參數描述
• 參數的有效範圍和默認值
• 示例用法場景

獲取您的希弗 API 密鑰

要獲取您的希弗 API 密鑰，請訪問 Hevy API 文檔 並按照身份驗證說明操作。您需要通過希弗開發者門戶網站註冊以獲取 API 訪問權限。

添加到 Cursor

要將此 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 替換為您的實際希弗 API 密鑰。

🔧 技術細節

發佈流程

此項目使用 semantic-release 進行自動化版本控制和包發佈。我們遵循 Conventional Commits 規範進行提交信息編寫。

技術文檔

有關安裝、配置、運行服務器、API 端點、服務方法和項目結構的詳細技術信息，請參閱 TECHNICAL.md。