FindMCP Logo FindMCP.info
Hevy MCP Server

Hevy MCP Server

site icon
2025.04.14 2
TypeScript健身数据管理AI 助手集成其它
Hevy MCP Server 是一个基于 TypeScript 和 Node.js 的服务器，通过 Model Context Protocol (MCP) 将 Hevy 健身数据与语言模型连接起来。该服务器从 Hevy API 获取数据，并提供工具来访问用户的锻炼历史、运动进展和个人记录。
View on GitHub

Overview

基本能力

产品定位

Hevy MCP Server 是一个连接 Hevy 健身数据与语言模型的中间件，旨在通过 MCP 协议让 AI 助手能够访问和分析用户的健身数据。

核心功能

  • 获取锻炼数据：获取指定日期范围内的锻炼记录，包括持续时间、运动量等统计信息。
  • 跟踪运动进展：根据运动 ID 和时间范围跟踪特定运动的进展，包括每组重复次数。
  • 获取运动数据：获取详细的运动数据，按使用频率排序，并可选择按名称和日期范围过滤。
  • 获取训练计划：检索用户保存的训练计划。

适用场景

  • AI 助手分析用户的健身数据
  • 个人健身数据管理和分析
  • 健身计划跟踪和优化

工具列表

  • get-workouts：获取指定日期范围内的锻炼记录。
  • get-exercise-progress-by-ids：跟踪特定运动的进展。
  • get-exercises：获取详细的运动数据。
  • get-routines：检索用户的训练计划。

常见问题解答

使用教程

使用依赖

  • Node.js 环境
  • Hevy API Key

安装教程

  1. 确保已安装 Node.js
  2. 获取 Hevy API Key
  3. 更新 ~/.cursor/mcp.json 文件，添加以下配置：
"hevy-mcp-server": {
  "command": "npx",
  "args": ["-y", "@vreippainen/hevy-mcp-server", "--stdio"],
  "env": {
    "HEVY_API_KEY": "your-api-key-here"
  }
}
  1. 替换 your-api-key-here 为实际的 Hevy API Key

调试方式

  • 检查 ~/.cursor/mcp.json 文件配置是否正确
  • 确保 Hevy API Key 有效
  • 运行 npx -y @vreippainen/hevy-mcp-server --stdio 测试服务器是否正常运行

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。