关于 OpenAthlete
OpenAthlete 是 MCP 服务和编码 Agent 插件,可整合 Garmin 与 COROS 的训练数据和能力。它会跨会话保留训练背景,支持个性化运动讨论与课表规划。
主要功能
- 01整合 Garmin 与 COROS 数据
- 02记住训练历史和个人偏好
- 03支持训练与恢复讨论
- 04分析比赛目标和战术
- 05经确认后将课表写回平台
适用场景
- 01结合个人训练背景讨论恢复
- 02评估伤病风险和比赛目标
- 03分析训练数据与装备需求
- 04规划课表并确认平台更新
MCP 相关
OpenAthlete 提供适用于 Claude Code 和其他 MCP 宿主的 MCP 包,让 Agent 使用 Garmin 与 COROS 数据和能力。课表和计划写回平台前会展示内容并请求确认。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
9收录的工具列表 · 更新于 1 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| days | integer | 否 | |
| end_date | string | 否 |
详细介绍
来自项目 READMEOpenAthlete
让 coding agent 成为真正懂你的 AI 教练。
OpenAthlete 统一佳明(Garmin)与高驰(COROS)的数据和能力,并跨会话记住你的 训练历史、伤病、目标与偏好,让 AI 在完整的个人语境中理解和帮助你。
能帮你做什么
训练与恢复、伤病与风险、比赛目标与战术、营养与装备、数据分析与资料查询…… 都可以直接讨论。它不局限于一套固定命令:凡是你能想到、AI 能结合数据和工具 完成的运动相关需求,都可以先问它。
安装与开始
Kimi Code:在会话中输入:
/plugins install https://github.com/whz14/openathlete
Codex:在终端执行:
codex plugin marketplace add https://github.com/whz14/openathlete && codex plugin add openathlete@openathlete
Claude Code 或其他 MCP 宿主:把这句话发给 agent:
使用 uvx openathlete-mcp 配置 OpenAthlete,并按 https://github.com/whz14/openathlete 的 AGENTS.md 完成初始化。
独立 MCP 包已发布到 PyPI 和 MCP Registry, 可由 agent 按需查询。
首次安装后按宿主要求重载或重启(Kimi Code 使用 /reload),然后另开一个与运动相关的
会话,即可进入初始化向导。环境、MCP、平台授权和偏好设置由 AI 引导或代办,
无需手动编写 MCP 配置。
之后不用背命令。直接问“你能做到什么”“你能不能……”“如何……”,它会说明 能做什么、需要哪些数据或授权,并带着你完成。
使用边界、隐私与风险
- 需要你自己的 agent 与模型:OpenAthlete 不提供模型订阅或使用额度。分析能力 取决于所选模型,易用性取决于 coding agent、可用工具与数据完整度;AI 可能出错, 重要判断请复核。
- 数据保存在本机,不等于数据不出机:安装更新会访问代码与依赖下载源,平台查询 和同步会访问对应 API,云端模型会收到随对话上下文发送的训练、健康和记忆数据。 账号凭据由你按向导在本机填写,不要贴进聊天。
- 平台接口有边界:部分能力使用非官方接口,存在风控、限流和失效风险;数据是否 完整也取决于平台开放能力和你的账号。高驰采用单点登录,同步或授权期间打开高驰 App/网页可能互踢;佳明账号需关闭两步验证(MFA)。
- 写入与健康边界:课表、计划等写回平台前会先展示内容并经你确认。AI 教练不提供 医疗诊断;出现严重伤病迹象请就医。
反馈与致谢
欢迎通过 Issues 提问题、需求或使用 场景,也欢迎按 贡献指南 提交改进。
感谢 XiaoSiHwang/garmin-sync-coros 提供的佳明→高驰同步基础,以及 garth 提供的 佳明通信能力。
本仓库自有代码以 MIT 发布。面向 coding agent 的完整文档见 AGENTS.md,产品与架构约定见 DESIGN.md。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。