hevy-mcp

概述

hevy-mcp 是一个基于 TypeScript 的 MCP 服务器，为 AI 助手提供 Hevy 健身跟踪平台的程序化访问权限。它允许 Claude Desktop 和 Cursor 用户通过一系列完善的 MCP 工具与其健身数据进行交互。该服务器支持训练管理、计划组织、锻炼模板浏览和 webhook 订阅，并包含适当的错误处理和内存缓存功能，以优化性能。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• get-workouts

  Fetch all workouts from your Hevy account

  试试:Get my last 5 workouts试试:Show me all my workouts this month
• get-workout

  Retrieve a specific workout by its ID

  试试:Get my workout from yesterday试试:Show me workout ID 12345
• create-workout

  Create a new workout session

  试试:Create a new chest and triceps workout试试:Add a new leg day workout
• update-workout

  Update an existing workout with new data

  试试:Update my workout ID 12345 with more sets试试:Modify my yesterday's workout
• get-workout-count

  Get the total count of workouts in your account

  试试:How many workouts have I logged?试试:Show me my workout total
• get-workout-events

  Fetch workout events from your account

  试试:What workout events do I have?试试:Show me my recent workout events
• get-routines

  Retrieve all workout routines from your account

  试试:Show me all my workout routines试试:List all my saved routines
• get-routine-by-id

  Get a specific routine by its ID

  试试:Show me routine ID 54321试试:Get details for my strength routine
• create-routine

  Create a new workout routine

  试试:Create a new push-pull-legs routine试试:Add a full body beginner routine
• update-routine

  Update an existing workout routine

  试试:Update my routine ID 54321 with new exercises试试:Modify my upper body routine
• get-exercise-templates

  Fetch available exercise templates

  试试:Show me all exercise templates试试:Get me back exercise options
• search-exercise-templates

  Search for exercise templates with specific criteria

  试试:Find chest press exercises试试:Search for back row variations

可对比工具

安装

HEVY_API_KEY=sk_live... npx -y hevy-mcp

git clone https://github.com/chrisdoc/hevy-mcp.git
cd hevy-mcp
npm install
cp .env.sample .env
# 编辑 .env 文件并添加你的 HEVY_API_KEY

{
  "mcpServers": {
    "hevy-mcp": {
      "command": "npx",
      "args": ["-y", "hevy-mcp"],
      "env": {
        "HEVY_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

FAQ

这个项目是否适用于 Hevy 的免费版？

不适用，需要 Hevy PRO 订阅才能访问 API。

哪些 AI 助手与 hevy-mcp 兼容？

设计用于 Claude Desktop 和 Cursor，但应该支持 stdio 传输的任何 MCP 客户端都能使用。

hevy-mcp 对比