Hevy Mcp

hevy-mcp

一个用于 Hevy 健身应用 API 的 Python Model Context Protocol (MCP) 服务。让 Claude（或任何兼容 MCP 的 AI）全面访问你的 Hevy 训练数据——记录训练、管理训练计划、跟踪身体测量数据等。

功能

• 25 个工具，涵盖 Hevy API 的所有端点
• 无需构建——纯 Python，安装后即可运行
• 完整的 CRUD 操作——创建、读取和更新训练、训练计划、动作模板、文件夹、测量数据和 Webhook

工具

类别	工具
用户	get_user_info
训练	get_workouts、get_workout、get_workout_count、get_workout_events、create_workout、update_workout
训练计划	get_routines、get_routine、create_routine、update_routine
训练计划文件夹	get_routine_folders、get_routine_folder、create_routine_folder
动作模板	get_exercise_templates、get_exercise_template、create_exercise_template
动作历史	get_exercise_history
身体测量数据	get_body_measurements、get_body_measurement、create_body_measurement、update_body_measurement
Webhook	get_webhooks、create_webhook、delete_webhook

要求

• Python 3.12+
• Hevy Pro 账户（API 访问必需）
• 从 hevy.com/settings?developer 获取的 API 密钥

安装

git clone https://github.com/srdjancodes/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