Arvo Mcp

Arvo MCP 服务 - Claude 健身与训练追踪器

健身追踪 MCP 服务 - 通过 Claude Desktop、Cursor 和其他 MCP 客户端记录健身房训练、追踪个人纪录（PR）、分析身体进展并管理训练分化。

arvo-mcp 是一款模型上下文协议（MCP）服务，可将你的 AI 助手连接到 Arvo，一位由 AI 驱动的健身教练。直接通过 Claude Desktop、Cursor 或任何兼容 MCP 的客户端访问你的训练历史、个人纪录、身体成分和训练计划。

非常适合希望实现以下目标的健身爱好者：

• 🏋️ 询问“我今天练什么？”并获取个性化训练计划
• 📊 借助 AI 洞察追踪健身进展
• 💪 监控 PR、训练量和肌群分布
• 📈 分析身体成分随时间的变化趋势

功能

• 29 款健身工具 - 个人资料、训练、分化、PR、身体进展等
• 读取和写入权限 - 查看数据，并通过自然对话进行更改
• 安全的 API 密钥身份验证 - 确保你的数据隐私
• 适用于任何 MCP 客户端 - Claude Desktop、Cursor、Windsurf 等

快速开始

1. 获取 API 密钥

1. 在 arvo.guru 注册或登录
2. 在网页应用中，打开设置 → API 密钥（如果看到的是简化版设置，请先切换到高级模式，或直接打开 https://arvo.guru/settings#api-keys）
3. 点击创建密钥并复制 API 密钥

API 密钥管理目前仅支持网页端，移动应用中不可用。

2. 配置 MCP 客户端

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "arvo": {
      "command": "npx",
      "args": ["-y", "arvo-mcp"],
      "env": {
        "ARVO_API_KEY": "arvo_your_api_key_here"
      }
    }
  }
}

配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

Cursor

将以下内容添加到 Cursor MCP 设置中：

{
  "mcpServers": {
    "arvo": {
      "command": "npx",
      "args": ["-y", "arvo-mcp"],
      "env": {
        "ARVO_API_KEY": "arvo_your_api_key_here"
      }
    }
  }
}

3. 开始对话！

重启 AI 客户端后，可以尝试询问：

• “我今天练什么？”
• “给我看看最近的 PR”
• “我的卧推进展怎么样？”
• “我这周在练哪些肌群？”

可用工具

只读工具（19 款）

工具	说明
get_user_profile	获取你的健身资料、经验水平和偏好
get_active_split	获取当前训练分化和计划安排
get_recent_workouts	查看最近完成的训练
get_workout_for_day	获取任意训练周期日的训练安排
get_workout_stats	获取汇总的训练统计数据
get_active_insights	查看 AI 生成的训练洞察
get_personal_records	查看每项练习的 PR
get_exercise_progress	追踪特定练习的进展
get_exercise_video	获取练习演示视频
get_volume_by_muscle	查看各肌群的训练量分布
get_coach_info	获取教练信息
get_coach_notes	查看教练的备注
get_approach_details	了解你的训练方法
get_body_progress	追踪身体成分变化
get_cycle_history	查看训练周期历史
get_booking_info	查看私人教练课程预约
get_ai_memory	访问已保存的关于你的 AI 上下文
get_caloric_history	查看热量阶段历史
get_approach_history	查看训练方法随时间的变化

写入工具（10）

工具	描述
save_memory	保存笔记，供 AI 记住
update_caloric_phase	更改当前的增肌／减脂／维持阶段
update_weak_points	更新重点训练肌群
report_physical_issue	记录疼痛或受伤情况
skip_exercise	跳过今天训练中的某项练习
generate_workout	生成新的训练计划
update_equipment	更新可用器材
add_exercise	将练习添加到训练计划中
swap_exercise	请求替换练习
apply_swap	应用练习替换

安全

• API 密钥存储在本地，绝不会发送给第三方
• 所有通信均使用 HTTPS
• 可随时从 Arvo 控制面板撤销 API 密钥
• 每个密钥都可配置权限范围（读取／写入）

如需报告安全漏洞，请参阅 SECURITY.md。

常见问题

什么是模型上下文协议（MCP）？

MCP 是一种开放协议，可让 Claude 等 AI 助手安全地访问外部数据源。arvo-mcp 让 Claude 能通过自然对话访问你的训练数据、训练记录和健身指标。

我的数据如何受到保护？

• API 密钥使用 SHA-256 哈希处理（绝不会以明文形式存储）
• 所有通信均使用 HTTPS 加密
• 可立即从控制面板撤销密钥
• 权限范围可限定为只读或读写
• API 密钥仅存储在你的本地设备上

可以离线使用吗？

不可以，arvo-mcp 需要连接互联网才能与 arvo.guru 服务通信。MCP 服务在本地运行，但会从云端获取你的数据。

支持哪些 AI 客户端？

Claude Desktop、Cursor、Windsurf，以及任何兼容 MCP 的客户端。该服务使用标准的 MCP stdio 传输方式，因此兼容任何支持该协议的客户端。

如何报告安全问题？

请发送邮件至 [email protected] 并附上详细信息。有关完整的安全政策和负责任披露流程，请参阅 SECURITY.md。

AI 可以访问哪些数据？

AI 可以访问你的训练计划、练习记录、个人纪录、身体成分追踪数据和教练笔记。写入工具可用于保存记忆、更新偏好设置和修改训练计划。你可以通过 API 密钥权限范围控制访问权限。

没有 Arvo 账户也能使用吗？

不可以，你需要 Arvo 账户才能生成 API 密钥。前往 arvo.guru 免费注册。

如何更新到新版本？

如果使用 npx -y arvo-mcp，它会自动获取最新版本。对于全局安装，请运行 npm update -g arvo-mcp。

环境变量

变量	必需	描述
ARVO_API_KEY	是	你的 Arvo API 密钥
ARVO_BASE_URL	否	API 基础 URL（默认值：https://arvo.guru）

系统要求

• Node.js 18+
• Arvo 账户（免费注册）

链接

• Arvo - AI 私人教练：arvo.guru
• 文档：arvo.guru/docs
• 报告问题：GitHub Issues
• MCP 协议：modelcontextprotocol.io
• npm 包：npmjs.com/package/arvo-mcp

相关内容

想要使用 AI 进行健身追踪？不妨看看：

• Arvo - AI 训练教练，可创建个性化训练计划
• 模型上下文协议 - 为此集成提供支持的开放协议

许可证

MIT - 详情请参阅 LICENSE。

---

🏋️ 使用 AI 追踪你的健身房训练
开始使用 Arvo →