hevy-mcp：Hevy Fitness API 的模型上下文协议服务器
模型上下文协议 (MCP) 服务器实现，可与Hevy 健身追踪应用及其API交互。该服务器使 AI 助手能够通过 Hevy API（需要 PRO 订阅）访问和管理锻炼数据、例程、锻炼模板等。
特征
锻炼管理：获取、创建和更新锻炼
日常管理：访问和管理锻炼计划
练习模板：浏览可用的练习模板
文件夹组织：管理常规文件夹
Related MCP server: AgentMode
先决条件
Node.js（v20 或更高版本）
npm 或 yarn
Hevy API 密钥
安装
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 hevy-mcp：
手动安装
与 Cursor 集成
要将此 MCP 服务器与 Cursor 一起使用，您需要通过添加以下配置来更新您的~/.cursor/mcp.json文件：
确保将your-api-key-here替换为您的实际 Hevy API 密钥。
配置
在项目根目录中创建一个.env文件，其内容如下：
将your_hevy_api_key_here替换为您的实际 Hevy API 密钥。
用法
发展
这将以开发模式启动 MCP 服务器并进行热重载。
生产
可用的 MCP 工具
该服务器实现了以下 MCP 工具：
健身工具
get-workouts：获取并格式化锻炼数据get-workout：通过 ID 获取单次锻炼create-workout：创建新的锻炼计划update-workout：更新现有的锻炼get-workout-count：获取锻炼总数get-workout-events：获取锻炼更新/删除事件
常规工具
get-routines：获取并格式化例程数据create-routine：创建一个新的例程update-routine：更新现有例程get-routine：通过 ID 获取单个例程
练习模板工具
get-exercise-templates：获取练习模板get-exercise-template：通过 ID 获取模板
常规文件夹工具
get-routine-folders：获取例程文件夹create-routine-folder：创建新文件夹get-routine-folder：通过 ID 获取文件夹
项目结构
发展
代码风格
该项目使用 Biome 进行代码格式化和 linting：
生成 API 客户端
API 客户端是使用 Kiota 根据 OpenAPI 规范生成的：
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。
贡献
欢迎贡献代码！欢迎提交 Pull 请求。