返回 MCP 目录
public公开dns本地运行

hevy-mcp

Hevy API的MCP服务器实现,提供与Hevy健身平台交互的工具集,包括训练记录、例行程序管理等功能。

article

README

🚀 hevy-api-mcp

hevy-api-mcp 是一个为 Hevy API 服务的 MCP 服务器,它为相关业务提供了稳定可靠的支持。

🚀 快速开始

你可以按照以下步骤来安装和使用 hevy-api-mcp。

📦 安装指南

  1. 克隆仓库并进入项目目录:
    git clone https://github.com/jcjiron/hevy-mcp.git
    cd hevy-mcp
    
  2. 安装依赖并进行构建:
    npm install
    npm run build
    

💻 使用示例

基础用法

你可以使用 npx 来运行 MCP 服务器(如果发布到 npm,可在本地或全局使用):

npx hevy-api-mcp

或者从你的 MCP 配置文件中运行:

{
  "mcpServers": {
    "hevy-api-mcp": {
      "command": "npx",
      "args": ["-y", "hevy-api-mcp"],
      "env": {
        "HEVY_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

高级用法

你可以在本地测试服务器:

HEVY_API_KEY=your_api_key npx hevy-api-mcp

或者使用 .env 文件:

npx hevy-api-mcp

🔧 技术细节

环境变量

  • HEVY_API_KEY:你的 Hevy API 密钥(必需)。 你可以在本地开发时使用 .env 文件:
HEVY_API_KEY=your_api_key

暴露工具

  • getWorkouts
  • getWorkoutById
  • createWorkout
  • updateWorkout
  • getRoutineFolders
  • getRoutineFolderById
  • createRoutineFolder
  • getExerciseTemplates
  • getExerciseTemplateById
  • getWebhookSubscription
  • createWebhookSubscription
  • deleteWebhookSubscription

如果你有任何问题或建议,请在仓库中创建一个 issue。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端