arvo-mcp 是一个健身追踪类 MCP 服务器，用于将 AI 助手与 Arvo（AI 驱动的健身教练）连接，让用户通过自然对话访问和管理自己的训练数据。
用途
该工具适合希望借助 AI 助手追踪健身进展的用户。它可以让 Claude Desktop、Cursor、Windsurf 或其他 MCP 兼容客户端直接获取训练历史、个人记录、身体成分和训练计划。典型用法包括询问“我今天练什么？”并获取个性化训练安排，或通过 AI 分析训练进展、监测 PR、训练容量和肌群分布，以及分析身体成分随时间的变化趋势。
主要能力
- 提供 29 项健身工具，覆盖个人资料、训练、分化计划、个人记录（PR）、身体进展等。
- 支持读写访问：既可以查看数据，也可以通过自然语言对话修改数据。
- 支持安全 API 密钥认证，密钥本地存储，从不发送给第三方；所有通信使用 HTTPS。
- 兼容任何 MCP 客户端，包括 Claude Desktop、Cursor、Windsurf 等。
- 读取类工具 19 项，写入类工具 10 项。
使用方式
-
获取 API 密钥：在 arvo.guru 注册或登录，在 Web 应用打开 Settings → API Keys（如显示简化设置，先切换到 Advanced 模式，或直接打开 https://arvo.guru/settings#api-keys），点击 Create Key 并复制密钥。注意 API 密钥管理目前仅限 Web 端，移动应用暂不提供。
-
配置 MCP 客户端：在 claude_desktop_config.json 中添加配置。配置文件位置：macOS 为 ~/Library/Application Support/Claude/claude_desktop_config.json；Windows 为 %APPDATA%\Claude\claude_desktop_config.json。也可将配置添加到 Cursor 的 MCP 设置中。
-
开始对话：重启 AI 客户端后，可以尝试提问，例如：“What's my workout for today?”、“Show me my recent PRs”、“How's my progress on bench press?”、“What muscle groups am I training this week?”
适用场景
- 健身爱好者在训练前查询当日训练计划。
- 通过 AI 分析长期训练进展、容量和肌群分布。
- 追踪个人记录（PR）和身体成分变化。
- 通过自然语言修改训练计划、偏好或保存记忆。
限制与说明
- 需要 Arvo 账户才能生成 API 密钥，没有账户无法使用。
- 不能离线使用：arvo-mcp 需要互联网连接与 arvo.guru 服务器通信；MCP 服务器虽在本地运行，但数据从云端获取。
- API 密钥使用 SHA-256 哈希存储，可随时在 Arvo 仪表板撤销，并支持配置作用域（只读或读写）。
- 更新方式：如使用 npx -y arvo-mcp 会自动获取最新版本；全局安装则运行 npm update -g arvo-mcp。
- 安全漏洞报告可发送邮件至 security@arvo.guru，详见 SECURITY.md。
项目采用 MIT 许可证，更多信息可参考 arvo.guru、arvo.guru/docs、GitHub Issues、modelcontextprotocol.io 以及 npmjs.com/package/arvo-mcp。
