hevy-mcp

一个用于 Hevy 健身应用 API 的 Python 模型上下文协议 (MCP) 服务器。让 Claude（或任何兼容 MCP 的 AI）能够完全访问您的 Hevy 锻炼数据——记录锻炼、管理例程、追踪身体测量数据等。

功能

• 25 个工具，涵盖 Hevy API 的每一个端点

• 无需构建步骤——纯 Python，安装即可运行

• 完整的 CRUD——创建、读取、更新锻炼、例程、练习模板、文件夹、测量数据和 Webhook

工具

要求

• Python 3.10+

• Hevy Pro 账户（API 访问必需）

• 来自 hevy.com/settings?developer 的 API 密钥

安装

git clone https://github.com/YOUR_USERNAME/hevy-mcp
cd hevy-mcp
pip install -r requirements.txt

配置

Claude Desktop

添加到 claude_desktop_config.json：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hevy": {
      "command": "python",
      "args": ["/absolute/path/to/hevy-mcp/server.py"],
      "env": {
        "HEVY_API_KEY": "your-api-key-here"
      }
    }
  }
}

重启 Claude Desktop。您应该能在聊天界面的工具图标下看到 Hevy 服务器。

环境变量

或者，在您的环境中设置 HEVY_API_KEY 并直接运行：

export HEVY_API_KEY=your-api-key-here
python server.py

使用示例

连接后，您可以询问 Claude 诸如：

• “显示我最近 5 次的锻炼记录”

• “记录我今天做的胸部锻炼——卧推 3 组 8 次，重量 100kg；上斜哑铃推举 3 组 10 次，重量 30kg”

• “创建一个推/拉/腿例程”

• “我过去一个月的体重趋势如何？”

• “查找罗马尼亚硬拉的练习模板 ID”

• “显示我过去 3 个月所有的卧推组数”

技术栈

• FastMCP — Python MCP 服务器框架

• httpx — HTTP 客户端

• Hevy API — 官方 REST API

许可证

MIT