Skip to content

uxgnod/coros-sports-data

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 

Repository files navigation

COROS 运动数据 Codex Plugin

这个仓库提供一个 Codex plugin,用 COROS 官方 MCP server 读取你的 COROS 运动、恢复、睡眠、训练负荷和日常健康数据,并生成训练就绪度、恢复和负荷分析。

默认配置是中国区:

https://mcpcn.coros.com/mcp

一键安装 Prompt

把下面这段完整复制给 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 和模板文件名里。

GitHub 安装说明

这个仓库按 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 等。

About

COROS sports data Codex plugin with MCP and training readiness analysis

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors