这个仓库提供一个 Codex plugin,用 COROS 官方 MCP server 读取你的 COROS 运动、恢复、睡眠、训练负荷和日常健康数据,并生成训练就绪度、恢复和负荷分析。
默认配置是中国区:
https://mcpcn.coros.com/mcp
把下面这段完整复制给 Codex,让它帮你完成安装、OAuth 登录和首次数据检查:
请帮我安装并启用 GitHub 上的 COROS 运动数据 Codex plugin,并在授权完成后用它生成我的今日训练就绪度建议。
请按下面步骤执行:
1. 先检查当前 Codex 是否已经存在名为 coros 的 MCP server:
- 运行 `codex mcp list`
- 如果已有 `coros`,确认它是否来自 `uxgnod/coros-sports-data` plugin;如果不是,请先说明情况,不要直接覆盖。
2. 添加这个 GitHub repo 作为 Codex plugin marketplace:
- 运行 `codex plugin marketplace add uxgnod/coros-sports-data`
- 如果已经添加过,则运行 `codex plugin marketplace upgrade coros-sports-data`
3. 启用 plugin:
- 确认 `~/.codex/config.toml` 中存在:
`[plugins."coros-sports-data@coros-sports-data"]`
`enabled = true`
- 如果不存在,请添加这个配置项。
4. 触发 COROS MCP OAuth 登录:
- 运行 `codex mcp login coros`
- 如果命令输出授权 URL,请帮我打开浏览器;我会手动登录 COROS 并授权。
- 等待命令返回 `Successfully logged in to MCP server 'coros'.`
5. 安装完成后验证:
- 运行 `codex mcp list`
- 确认 `coros` 的 URL 是 `https://mcpcn.coros.com/mcp`,状态是 enabled,Auth 是 OAuth。
6. 最后请使用 COROS 运动数据 plugin / skill,帮我生成“今日训练就绪度建议”:
- 查询恢复、HRV/RHR、睡眠、压力、训练负荷和最近运动记录。
- 输出 Readiness 0-100、Green/Yellow/Red、今日训练建议、允许强度、主要限制因素、证据表和 confidence。
- 如果某些 COROS 指标不可用,请明确说明缺失项,不要编造数据。
.agents/plugins/marketplace.json
plugins/coros-sports-data/
.codex-plugin/plugin.json
.mcp.json
mcp-templates/
cn.mcp.json
us.mcp.json
eu.mcp.json
skills/coros-sports-data/
SKILL.md
references/use-cases.md
references/metrics-and-methods.md
agents/openai.yaml
assets/
icon.png
logo.png
插件默认使用 plugins/coros-sports-data/.mcp.json,内容等同于 mcp-templates/cn.mcp.json。
其他地区需要把对应模板内容复制到:
plugins/coros-sports-data/.mcp.json
地区 URL:
| 地区 | MCP URL | 模板 |
|---|---|---|
| 中国区 | https://mcpcn.coros.com/mcp |
mcp-templates/cn.mcp.json |
| 北美或其他地区 | https://mcpus.coros.com/mcp |
mcp-templates/us.mcp.json |
| 欧洲区 | https://mcpeu.coros.com/mcp |
mcp-templates/eu.mcp.json |
.json 文件不能写注释,所以不要在 .mcp.json 里用 // 或 /* ... */ 标注默认地区。地区说明放在 README 和模板文件名里。
这个仓库按 repo plugin 的结构组织:根目录有 .agents/plugins/marketplace.json,插件本体在 plugins/coros-sports-data/。
安装这个 GitHub repo 作为 Codex plugin marketplace:
codex plugin marketplace add uxgnod/coros-sports-data然后在 Codex 的插件界面启用 COROS 运动数据。如果你使用的是当前 CLI 流程,也可以在 ~/.codex/config.toml 中确认存在下面的启用项:
[plugins."coros-sports-data@coros-sports-data"]
enabled = true启用后触发 COROS MCP OAuth 登录:
codex mcp login coros也可以锁定一个 tag:
codex plugin marketplace add uxgnod/coros-sports-data --ref v0.1.0如果想先 clone 到本地检查:
git clone https://github.com/uxgnod/coros-sports-data.git
cd coros-sports-data这个 repo 的根目录包含 .agents/plugins/marketplace.json,Codex 会通过它发现 plugins/coros-sports-data/。
OAuth 登录会在首次连接 COROS MCP server 时发生。插件不保存 COROS 账号密码。
- 生成我的今日训练就绪度建议。
- 分析我最近一次跑步并给出改进建议。
- 生成我最近 7 天的训练负荷和恢复周报。
- 最近训练是不是太多了?
- 睡眠有没有影响我的训练恢复?
- 这个月跑步状态比上个月进步了吗?
- 看看我接下来一周训练安排是否匹配当前恢复状态。
插件内置的 skill 不只会查询原始数据,还包含一组可复用分析 playbook:
| 用例 | 适合的问题 |
|---|---|
| 训练周报 | 最近 7 天 / 上周训练复盘 |
| 单次运动深度分析 | 最近一次跑步、昨天骑行、某次活动表现 |
| 今日训练就绪度 | 今日适合训练、恢复还是休息 |
| 睡眠影响复盘 | 睡眠是否影响恢复和训练 |
| 训练负荷风险检查 | 最近是否练太多、是否需要降负荷 |
| 体能趋势快照 | 这个月是否比上个月进步 |
| 训练计划预览 | 未来训练安排是否匹配当前恢复 |
| 数据 / 设备检查 | 能查到什么数据、是否有同步问题 |
这些 playbook 在 plugins/coros-sports-data/skills/coros-sports-data/references/use-cases.md。专业术语、计算方法和阈值参考在 plugins/coros-sports-data/skills/coros-sports-data/references/metrics-and-methods.md,包括 HRV/rMSSD、RHR 偏离、sleep sufficiency、ACWR、TRIMP、HRR/Karvonen、training monotony/strain、aerobic decoupling 等。