exerciseapi

@exerciseapi/mcp-server

exerciseapi.dev 的官方 MCP 服务——让你的 AI 编码 Agent 直接访问涵盖 12 个类别的 2,198+ 个精选动作。

正在使用 Claude Code、Cursor、Windsurf 或 Cline 构建健身、锻炼、训练、康复或健康应用？别再让你的 Agent 编造动作数据了。安装此 MCP 服务后，你的 Agent 就能使用六种工具，直接从 exerciseapi.dev 动作库中获取真实、结构化的动作数据。

为何开发此服务

大模型会幻觉出动作指导，编造肌肉群，还会混淆动作要领。它们甚至会一本正经地建议你做“反握上斜绳索飞鸟”，并给出可能伤人的安全提示。

此服务让你的 Agent 能够访问：

• 2,198+ 个动作，涵盖力量训练、徒手训练、瑜伽、普拉提、活动度训练、物理治疗、增强式训练、拉伸等
• 真实的解剖学肌肉数据——包括主要和次要肌肉，提供具体肌肉而非仅仅“胸部”或“腿部”
• 由真人撰写的动作要领和安全提示，而非生成内容
• 器械、难度和类别筛选条件，帮助 Agent 制定准确的训练计划
• 动作演示视频，目前已覆盖并持续增加

这是对 exerciseapi.dev REST API 的轻量封装。所有筛选和搜索都在服务端运行——MCP 层只负责将其封装为可调用的工具。

安装

1. 获取免费 API 密钥

前往 exerciseapi.dev/dashboard 注册。免费套餐每天提供 100 次请求，足以满足开发需求。无需信用卡。

2. 添加到 MCP 客户端

Claude Desktop / Claude Code——添加到 ~/.config/claude/claude_desktop_config.json（或项目的 .mcp.json）：

{
  "mcpServers": {
    "exerciseapi": {
      "command": "npx",
      "args": ["-y", "@exerciseapi/mcp-server"],
      "env": {
        "EXERCISEAPI_KEY": "exlib_your_key_here"
      }
    }
  }
}

Cursor——添加到项目中的 .cursor/mcp.json：

{
  "mcpServers": {
    "exerciseapi": {
      "command": "npx",
      "args": ["-y", "@exerciseapi/mcp-server"],
      "env": {
        "EXERCISEAPI_KEY": "exlib_your_key_here"
      }
    }
  }
}

Windsurf、Cline、Zed——配置格式相同，粘贴到客户端的 MCP 配置中即可。

3. 重启 Agent

重启 Claude Desktop / Cursor / Windsurf，让它加载新的服务。完成。

试用

安装后，可以向 Agent 提出类似这样的请求：

帮我找五个只需哑铃就能完成的胸部动作，难度为中级。每个动作都列出动作要领。

Agent 会使用正确的筛选条件调用 search_exercises，获取真实数据，并根据动作库中的信息给出准确答复，不会产生幻觉。

或者：

我正在开发一款适合初学者的全身训练应用。请从推、拉和腿部动作中挑选 8 个无需器械的动作。

或者：

从肌肉激活的角度来看，杠铃卧推和哑铃卧推有什么区别？

工具

此服务提供六种工具：

工具	功能
search_exercises	按名称、类别、肌肉、器械或难度搜索动作库。最多返回 100 个动作。
get_exercise	根据 ID 获取单个动作的完整详情，包括指导、动作要领、安全提示、变式和视频。
list_categories	列出全部 12 个动作类别及其数量。
list_muscles	列出可用作筛选条件的解剖学肌肉。
list_equipment	列出可用作筛选条件的器械类型。
get_stats	动作库整体统计数据：总数、各类别数量和视频覆盖情况。

完整的工具参考请见 MCP 文档页面。

为什么选择 exerciseapi.dev？

	exerciseapi.dev	ExerciseDB	free-exercise-db	API Ninjas
运动数量	2,198（目标为 10,000+）	~1,300	~800	~3,000
类别	12 种（力量训练、瑜伽、PT、灵活性训练、普拉提等）	仅力量训练	仅力量训练	7 种类型
搜索关键词	✅ 每项运动 5–10 个	❌	❌	❌
动作指导	✅ 每项运动 3–4 条	❌	❌	❌
安全提示	✅ 详细	❌	❌	基本
具体解剖肌肉	✅	✅	❌	❌
变体	✅ 每项运动 3–5 种	❌	❌	❌
演示视频	✅ 持续增加	✅ GIF	❌	❌
MCP 服务	✅ 此软件包	❌	❌	❌
免费套餐	每天 100 次请求	无	不适用（静态）	每月 100 次请求
付费套餐起价	$5/月	$10/月	—	$10/月

专为使用 AI 编码 Agent 的开发者打造。架构、工具说明和文档格式都经过专门设计，让大模型能够上手并首次就正确使用。

配置

必需的环境变量

变量	说明
EXERCISEAPI_KEY	你在 exerciseapi.dev/dashboard 获取的 API 密钥。必需。若缺少此密钥，服务将在启动时退出。

可选的环境变量

变量	默认值	说明
EXERCISEAPI_BASE_URL	https://api.exerciseapi.dev	覆盖 API 基础 URL。适用于自托管或针对预发布环境进行测试。

故障排除

“EXERCISEAPI_KEY environment variable not set” 你忘记在 MCP 客户端配置中添加密钥，或者添加后没有重启客户端。请仔细检查配置文件中的 JSON，然后重启。

“API key is invalid” 密钥未通过验证。请在 exerciseapi.dev/dashboard 生成新密钥并更新配置。

“Daily quota reached” 你已达到免费套餐每天 100 次请求的上限。可以等到明天（UTC 午夜重置），也可以在 exerciseapi.dev/pricing 升级套餐。

Agent 没有使用这些工具 有两个常见原因：（1）服务未启动——查看客户端的 MCP 服务日志，通常位于开发者控制台或日志文件中。（2）Agent 认为这些工具不相关。试着更明确地提问：“使用 exerciseapi 工具帮我查找……”

首次运行时冷启动较慢 npx -y @exerciseapi/mcp-server 会在首次使用时下载软件包。若要避免每次重启时都下载，请全局安装：npm install -g @exerciseapi/mcp-server，然后在配置中将 command 改为 exerciseapi-mcp。

直接访问 API（无需 MCP）

如果你更愿意直接调用 REST API，而不是使用 MCP——例如，你正在构建服务端集成，或者你使用的不是受支持的 MCP 客户端——请参阅 exerciseapi.dev/docs。同一个 API 密钥可用于两者。

此外，首页上还有一个通用的复制粘贴提示词，你可以将它粘贴到任何 AI 编码工具中，一次性完成可用的集成，无需 MCP。

贡献

欢迎提交问题和 PR。此服务有意保持为轻量封装——如果你想修改某些逻辑，它可能应该属于 REST API（私有仓库）。如果不确定，请先提出问题。

许可证

MIT © Vegh Labs LLC

---

由 West Vegh 构建。如果它为你省下了一个周末的运动数据基础设施开发时间，欢迎在控制台打声招呼，或发邮件至 [email protected]。