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 整合 Garmin 與 COROS 的訓練資料,為 AI 助理提供負荷與恢復分析、跨工作階段記憶與課表建立能力。

可以做什麼
  • 以一頁總覽近期訓練、統一負荷、恢復狀態與下一場賽事,必要時增量同步。
  • 查詢標準化活動紀錄,可選擇附上結構與區間明細。
  • 讀取訓練負荷趨勢(Edwards TRIMP 與 PMC)及靜息心率、睡眠 HRV 等恢復指標。
  • 觸發活動與每日指標的增量同步。
  • 讀取目前進行中的計畫與本週日誌。
  • 讀寫白名單內的 Markdown 記憶檔案,提供跨工作階段的脈絡。
適用情境
適合希望 AI 助理結合自身 Garmin 或 COROS 訓練歷史,討論訓練、恢復、受傷風險、比賽目標、營養與裝備,並把課表寫回平台的運動愛好者。
執行需求
以 stdio 本機程序執行,透過 uvx 啟動 PyPI 上的 openathlete-mcp 套件,僅支援桌面端。需自備 coding agent 與模型,並在引導流程中於本機填寫自己的 Garmin 與 COROS 帳號憑證。安裝、平台 API 呼叫與雲端模型皆需網路連線。
安裝前請注意
資料保存在本機,但不代表不會離開本機:同步會呼叫平台 API,雲端模型會收到隨對話傳送的訓練、健康與記憶資料。帳號憑證請在本機填寫,不要貼進聊天。部分功能使用非官方介面,有限流與失效風險;COROS 單一登入可能讓 App 被登出,Garmin 帳號需關閉兩步驟驗證。課表寫回前會先顯示並經確認。不提供醫療診斷。

安裝

在 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 整合