Hevy 健身数据 MCP 服务器使用说明

项目简介

Hevy 健身数据 MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在将您的 Hevy 健身应用数据与大型语言模型 (LLM) 连接起来。通过此服务器，您可以让 AI 助手访问和分析您的健身数据，例如训练历史、运动进度和个人记录，从而实现更智能的健身分析和个性化建议。

主要功能点

数据桥梁: 连接 Hevy 健身 API，将您的健身数据安全地提供给 LLM。
工具集: 提供一系列预定义的工具，方便 LLM 客户端获取和分析您的健身数据：
- 'get-workouts': 获取指定日期范围内的训练记录，最多返回 10 条，包含训练时长和总负重等统计信息。
- 'get-exercise-progress-by-ids': 追踪特定运动在一段时间内的进度，包括次数记录。
- 'get-exercises': 获取全面的运动数据，按使用频率排序，并可按名称和日期范围过滤，返回实际和预估的 1RM（单次最大重复重量）。
- 'get-routines': 获取您在 Hevy 应用中保存的训练计划。
标准化协议: 基于 MCP 协议，确保与各种 MCP 客户端的兼容性和互操作性。

安装步骤

安装 Node.js 和 npm: 确保您的系统已安装 Node.js 和 npm (Node 包管理器)。您可以从 nodejs.org 下载并安装。
获取 Hevy API 密钥: 访问 Hevy API 文档，按照说明注册并获取您的 Hevy API 密钥。您需要在 Hevy 开发者门户注册以获取 API 访问权限。

安装 MCP 服务器: 使用 npm 安装 '@vreippainen/hevy-mcp-server' 包。打开终端并执行命令：

npm install -g @vreippainen/hevy-mcp-server

服务器配置

MCP 服务器需要配置在 MCP 客户端中才能使用。以下是在 MCP 客户端（如 Cursor）中配置 'hevy-mcp-server' 的 'mcp.json' 示例配置信息：

{
  "hevy-mcp-server": {
    "command": "npx",
    "args": ["-y", "@vreippainen/hevy-mcp-server", "--stdio"],
    "env": {
      "HEVY_API_KEY": "YOUR_HEVY_API_KEY"
    }
  }
}

配置参数说明:

'"hevy-mcp-server"': 服务器名称，在 MCP 客户端中用于标识和调用此服务器。您可以自定义名称。
'"command": "npx"': 指定启动服务器的命令为 'npx'，用于执行 Node.js 包。
'"args": ["-y", "@vreippainen/hevy-mcp-server", "--stdio"]': 'args' 数组定义了传递给 'npx' 命令的参数：
- '"-y"': 'npx' 的参数，表示自动同意安装包。
- '"@vreippainen/hevy-mcp-server"': 指定要执行的 npm 包为 '@vreippainen/hevy-mcp-server'，即我们安装的 MCP 服务器包。
- '"--stdio"': 指定服务器使用 'stdio' (标准输入输出) 作为 MCP 的传输协议，这是与 MCP 客户端通信的方式。
'"env": { "HEVY_API_KEY": "YOUR_HEVY_API_KEY" }': 'env' 对象定义了服务器运行时需要的环境变量：
- '"HEVY_API_KEY": "YOUR_HEVY_API_KEY"': 设置 'HEVY_API_KEY' 环境变量，用于存储您的 Hevy API 密钥。请务必将 '"YOUR_HEVY_API_KEY"' 替换为您在 Hevy 开发者门户获取的真实 API 密钥。

配置步骤:

找到您的 MCP 客户端的配置文件 'mcp.json'。例如，Cursor 的配置文件通常位于 '~/.cursor/mcp.json'。
将上述 JSON 配置信息添加到 'mcp.json' 文件中。如果文件不存在，则创建该文件。
重要: 将 '"YOUR_HEVY_API_KEY"' 替换为您真实的 Hevy API 密钥。

基本使用方法

配置完成后，您的 MCP 客户端（如 Cursor）应该能够识别并连接到 'hevy-mcp-server'。您可以使用客户端提供的界面或命令来调用服务器提供的工具。

例如，在 Cursor 中，您可以使用 '@hevy-mcp-server' 加上工具名称来调用相应的工具，例如：

@hevy-mcp-server/get-workouts startDate="2023-01-01" endDate="2023-01-31"

这将调用 'hevy-mcp-server' 的 'get-workouts' 工具，并传递 'startDate' 和 'endDate' 参数来获取 2023 年 1 月份的训练记录。

您可以参考各个工具的描述和参数定义，根据需要调用不同的工具来查询和分析您的 Hevy 健身数据。

关键词