OpenAthlete

io.github.whz14由 GitHub 账号 whz14 发布v0.1.1更新于 Oct 30, 2026

Unified Garmin and COROS training data, analysis, memory, and workout scheduling for AI agents

发布方自己的服务:OpenAthlete

概览

AI 生成的概览

OpenAthlete 统一佳明与高驰的训练数据,为 AI 助手提供负荷与恢复分析、跨会话记忆和课表创建能力。

可以做什么
  • 一页查看近期训练、统一负荷、恢复状态与下一赛事,必要时增量同步。
  • 查询规范化活动记录,可选择附带结构与区间明细。
  • 读取训练负荷趋势(Edwards TRIMP 与 PMC)及静息心率、睡眠 HRV 等恢复指标。
  • 触发活动与日度指标的增量同步。
  • 读取当前进行中的计划与本周日志。
  • 读取和写入白名单内的 Markdown 记忆文件,实现跨会话上下文。
适用场景
适合希望 AI 助手结合自己的佳明或高驰训练历史,讨论训练、恢复、伤病风险、比赛目标、营养与装备,并把课表写回平台的运动爱好者。
运行要求
以 stdio 本地进程运行,通过 uvx 启动 PyPI 上的 openathlete-mcp 包,仅支持桌面端。需要自备 coding agent 与模型,并在引导流程中于本机填写自己的佳明和高驰账号凭据。安装、平台接口调用和云端模型均需网络访问。
安装前请注意
数据保存在本机,但不等于不出本机:同步会访问平台 API,云端模型会收到随对话发送的训练、健康与记忆数据。账号凭据请在本机填写,不要贴进聊天。部分能力使用非官方接口,存在限流与失效风险;高驰单点登录可能把 App 挤下线,佳明账号需关闭两步验证。课表写回前会先展示并经确认。不提供医疗诊断。

安装

在 SourceWeft 中

  1. 打开 控制台中的 OpenAthlete,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

OpenAthlete

让 coding agent 成为真正懂你的 AI 教练。

OpenAthlete 统一佳明(Garmin)与高驰(COROS)的数据和能力,并跨会话记住你的 训练历史、伤病、目标与偏好,让 AI 在完整的个人语境中理解和帮助你。

能帮你做什么

训练与恢复、伤病与风险、比赛目标与战术、营养与装备、数据分析与资料查询…… 都可以直接讨论。它不局限于一套固定命令:凡是你能想到、AI 能结合数据和工具 完成的运动相关需求,都可以先问它。

安装与开始

Kimi Code:在会话中输入:

text
/plugins install https://github.com/whz14/openathlete

Codex:在终端执行:

bash
codex plugin marketplace add https://github.com/whz14/openathlete && codex plugin add openathlete@openathlete

Claude Code 或其他 MCP 宿主:把这句话发给 agent:

text
使用 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。

来源:README.md,提交 5c59a08

工具

9

get_overview

一页查看近期训练、统一负荷、恢复和下一赛事;必要时按覆盖状态增量同步。

输入参数daysend_date

query_activities

查询 canonical 活动;detail=true 时附结构与细区间,不返回原始 FIT 或本地路径。

输入参数dayslimitsportdetailend_datestart_date

get_training_load

读取本地 Edwards TRIMP 与 PMC 趋势,并显示锚点和历史覆盖范围。

输入参数daysend_date

get_recovery_status

读取指定日期的静息心率、睡眠 HRV 与缺失项;不生成虚假恢复评分。

输入参数date

sync_now

立即对活动和日度指标各执行至多一个增量批次;长任务由调用方继续。

无需输入参数。

get_current_plan

读取当前日期覆盖的唯一进行中计划及本周日志;v0 不读取平台日程。

输入参数date

read_memory

读取一个白名单记忆文件,或以 list 枚举白名单档案;name/list 必须二选一。

输入参数listname

write_memory

以模板校验、原子替换和可选哈希并发控制写入白名单 Markdown 记忆。

输入参数name必填content必填allow_createexpected_sha256

create_workout

预览或确认创建单次课表;按 platform 路由 COROS 官方 MCP 或 Garmin API。

输入参数workout必填confirm_token

版本历史

2
  1. v0.1.1最新Oct 30, 2026
  2. v0.1.0Oct 30, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Openathlete 集成