mcpField
O
OpenAthlete

OpenAthlete

本地服务
github.com/whz14健康医疗01 周前更新

关于 OpenAthlete

OpenAthlete 是 MCP 服务和编码 Agent 插件,可整合 Garmin 与 COROS 的训练数据和能力。它会跨会话保留训练背景,支持个性化运动讨论与课表规划。

主要功能

  1. 01整合 Garmin 与 COROS 数据
  2. 02记住训练历史和个人偏好
  3. 03支持训练与恢复讨论
  4. 04分析比赛目标和战术
  5. 05经确认后将课表写回平台

适用场景

  1. 01结合个人训练背景讨论恢复
  2. 02评估伤病风险和比赛目标
  3. 03分析训练数据与装备需求
  4. 04规划课表并确认平台更新

MCP 相关

OpenAthlete 提供适用于 Claude Code 和其他 MCP 宿主的 MCP 包,让 Agent 使用 Garmin 与 COROS 数据和能力。课表和计划写回平台前会展示内容并请求确认。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"whz14-openathlete": {
"command": "uvx",
"args": [
"openathlete-mcp"
]
}
}
}
启动命令uvx openathlete-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
pypiopenathlete-mcp0.1.1

工具

9

收录的工具列表 · 更新于 1 周前

参数类型必填说明
daysinteger否
end_datestring否

详细介绍

来自项目 README

OpenAthlete

让 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。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。