WorkoutX Exercise API

WorkoutX MCP 服务 — 面向 AI Agent 的运动与健身 API

为 Claude Code、Cursor、ChatGPT、Grok、VS Code 和 Claude Desktop 提供 WorkoutX Exercise API：包含 1,900 多种运动及 720p MP4 动画（男性和女性模型）、训练和多周计划生成器、按证据评级的补剂数据库，以及用于构建健身应用的开发者工具：类型化模型、代码示例、请求调试和使用统计。

“使用 WorkoutX 的 45 分钟哑铃胸部训练，为应用添加一个训练界面。” “为运动和训练生成 Swift 模型。” “为什么从昨天开始就出现 429 错误？”

• 托管端点：https://api.workoutxapp.com/mcp（Streamable HTTP）——无需运行任何内容
• **身份验证：**在 X-WorkoutX-Key 标头中提供你的 WorkoutX API 密钥（或使用 Authorization: Bearer）
• **免费套餐：**500 次请求，无需信用卡 — 获取密钥
• 每次工具调用计为一次 API 请求，套餐限额与 REST API 相同
• 文档和设置指南：workoutxapp.com/mcp.html

工具

开发者工具

工具	功能
get_endpoint_reference	任意 v2 端点的参数、响应结构、错误和 curl 示例
generate_types	TypeScript、Swift（Codable）、Kotlin（kotlinx.serialization）或 Dart 模型
get_code_example	React Native、Swift、Flutter、Next.js、Node 和 Python 代码片段：列表、带链接刷新的视频播放、训练、错误处理、后端代理
diagnose_request	粘贴失败的请求（以及状态码／正文）：获取原因和修复方法。不会发送该请求

运动数据、训练和补剂

工具	功能
get_usage_stats	请求数、成功率、p95 延迟、按状态码统计的错误、热门端点、配额和媒体限额
export_exercise_seed	将运动 ID、名称、肌肉和器材导出为 JSON 或 CSV，不含媒体（不占用媒体限额）
get_trending_exercises	WorkoutX 应用中请求最多的运动和筛选条件，已匿名化
search_exercises	搜索和筛选目录；可使用 fields 和 includeMedia 获取更精简的响应
get_exercise	单项运动：说明、提示、肌肉、卡路里、媒体链接
get_exercise_media	获取新的签名 MP4 和缩略图链接
list_exercise_filters	有效的身体部位、目标、器材、类别和肌肉
find_exercise_alternatives	针对相同肌肉的替代动作，可指定器材，也可不指定
find_similar_exercises	按相似度排序的运动
estimate_calories	根据体重和时长估算卡路里
map_v1_exercise	v1 运动 ID → v2 运动
generate_workout	完整的单次训练，包含热身、组数／次数／休息时间和冷身（Growth+）
generate_program	包含周期化安排和减量周的多周计划（Scale）
search_supplements	包含证据、剂量和服用时间的补剂（Growth+）
get_supplement_stack	针对目标推荐的补剂组合（Scale）
check_api_key	套餐和剩余配额

所有工具均为只读，且需要 API 密钥；每次调用计为一次 API 请求。

连接

Claude Code

claude mcp add --transport http workoutx https://api.workoutxapp.com/mcp --header "X-WorkoutX-Key: wx_your_key"

Cursor（~/.cursor/mcp.json）和 VS Code

{
  "mcpServers": {
    "workoutx": {
      "url": "https://api.workoutxapp.com/mcp",
      "headers": { "X-WorkoutX-Key": "wx_your_key" }
    }
  }
}

Claude Desktop（一键安装）

下载 workoutx.mcpb（也可在发布页面获取）并打开。Claude Desktop 会安装扩展并提示你输入 API 密钥。

Claude Desktop（手动配置）和其他仅支持 stdio 的客户端

此软件包将 stdio 桥接到托管端点：

{
  "mcpServers": {
    "workoutx": {
      "command": "npx",
      "args": ["-y", "workoutx-mcp"],
      "env": { "WORKOUTX_API_KEY": "wx_your_key" }
    }
  }
}

变量	必填	默认值
WORKOUTX_API_KEY	是	—
WORKOUTX_MCP_URL	否	https://api.workoutxapp.com/mcp

开发

npm install && npm run build
npm run smoke                                            # against production
WORKOUTX_MCP_URL=http://localhost:3000/mcp npm run smoke # against a local API

链接

• 网站：workoutxapp.com · MCP 指南：workoutxapp.com/mcp.html
• REST API 文档：workoutxapp.com/docs.html
• SDK：JavaScript · Python · Swift · Flutter
• 支持：[email protected]

采用 MIT 许可证。