Skip to content

garmin-sports-coach-mcp

Verified

garmin-sports-coach-mcp · v0.1.10 · MIT · Web UI

佳速度教练助手:用对话查看训练营、创建训练、安排课程与课表。由于训练营数据改动较多,改动前会需要你确认才会提交。支持 DSH 插件与 MCP。

Install

dsh plugin add garmin-sports-coach-mcp

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Published to npm without a public repository. Inspect the package contents before installing.

Readme

佳速度教练助手

面向佳速度教练的 DSH 插件与 MCP 连接器,用自然语言管理训练营的课程、训练与课表。

npm 版本 npm 下载量 License: MIT

让助手帮你查看训练安排、整理训练库、把课程安排到具体日期。你只需要说清楚准备怎么练,就能用对话完成日常排课工作。

适合正在使用 佳速度(Garmin Sports) 带训练营的教练。这里管理的是训练营里的课程与课表;个人 Garmin Connect 日历可使用 dsh-plugin-garmin-connect。

由于训练营数据改动较多,改动前会需要你确认才会提交。

DeepSeek Harness、WorkBuddy、千问办公、ZCode、Claude Code、Codex、Cursor 与 Windsurf

支持主流 Coding Agent 与 AI 工作台
DeepSeek Harness · WorkBuddy · 千问办公 · ZCode · Claude Code · Codex · Cursor · Windsurf
支持 MCP 接入,也可在 DeepSeek Harness 中作为插件使用。

我的更多应用

图标 应用 一句话介绍
WristTale WristTale 在 Garmin、Apple、Android 手表上阅读 TXT 和 Markdown 电子书
JiaKe.app JiaKe.app 把 Garmin 截图做成精美宣传图
GameraSnap GameraSnap 用佳明手表远程控制手机拍照/录像
WristAlbum WristAlbum 在佳明手表上保存私人照片相册
WristPass WristPass 把会员卡、票券装进手腕,随时出示
2FA4G 2FA4G 在佳明手表上保存离线两步验证码

这个插件做什么?

  • 查看训练安排:找到你管理的训练营,查看课程、本周课表和训练详情。
  • 创建训练:编排热身、间歇、恢复和放松,设置时间、距离、配速或心率目标。
  • 安排新周期:在已有训练营里新建课程,一次安排整周或多周课表。
  • 调整课表:增减训练日、更换训练内容、调整训练日期。
  • 复用已有安排:复制课程,把整张课表的日期后移到下一个周期。
  • 整理课程与训练库:查看、修改或删除内容,提交前先核对改动范围。

例如,你可以直接对助手说:

列出我管理的佳速度训练营,让我选一个,再看看它本周的课表。

把选中的课程复制为“下周训练”,所有日期后移 7 天,先给我预览。

帮我预览一节 6×800 米间歇训练,组间慢跑 2 分钟。

开始前先准备好

  1. 教练权限与训练营。 先在佳速度申请成为教练,取得相应权限,并在官网创建训练营,或确认已有训练营的管理权限。插件目前不能直接创建训练营。
  2. 同一个佳明账号。 登录插件时,使用管理上述训练营的账号。登录成功不代表已经有教练或管理权限。
  3. Chrome 或 Edge 浏览器。 登录会打开一个独立的官方浏览器窗口。密码和验证码在佳明页面输入,不用发给助手。

教练申请与建营可参考 佳明官方教练指南,具体入口以当前官网为准。

快速开始:DSH

1. 安装插件

打开「插件 → 添加插件(Add plugin)」,输入下面的包名,安装并启用:

garmin-sports-coach-mcp

首次启用会出现三步新手指南。选择“稍后设置”或关闭后不会反复弹出,以后可在插件设置中点击“新手指南”重看。

2. 登录佳速度

在插件设置中点击“在浏览器登录”,使用管理训练营的同一个佳明账号,完成官方登录与验证。回到 DSH,看到“已连接”即可。

密码和验证码只在佳明官方页面输入,不需要发给助手。登录状态保存在本机。

3. 开始对话

在聊天里发送第一句话:

列出我管理的佳速度训练营,先不要修改任何课表。

确认找到了正确训练营后,再提出排课或调整需求。助手会列出涉及的课程、日期和训练内容,请核对后按提示确认。

接入其他 MCP 客户端

电脑需要安装 Node.js 22.4 或更新版本,以及 Chrome 或 Edge。

先在运行客户端的这台电脑上完成一次登录:

npx -y --package=garmin-sports-coach-mcp garmin-coach-auth login

然后把下面的配置添加到客户端的 MCP 设置中,并重新加载客户端:

{
  "mcpServers": {
    "garmin-sports-coach": {
      "command": "npx",
      "args": ["-y", "garmin-sports-coach-mcp"]
    }
  }
}

连接后,直接用前面的对话示例开始使用。不同客户端的设置入口可能不同。

国际版账号与时区设置

默认连接大陆版佳速度,课表日期使用北京时间。

国际版账号登录时,在命令末尾加上 --profile global;同时将上面的客户端配置替换为以下内容:

{
  "mcpServers": {
    "garmin-sports-coach": {
      "command": "npx",
      "args": ["-y", "garmin-sports-coach-mcp"],
      "env": {
        "GARMIN_COACH_PROFILE": "global"
      }
    }
  }
}

如果课表使用其他时区,可在同一个 env 中设置 GARMIN_COACH_TZ,例如 Europe/Berlin。登录和客户端配置应选择同一站点。

常见问题

已连接,却没有训练营或提示无权限?

先到佳速度官网确认账号、教练申请状态和该训练营的管理权限。仅注册佳明账号或成功登录,不会自动获得建营、编课权限。

登录窗口打不开?

确认本机已安装 Chrome 或 Edge。Safari、Firefox 暂不支持自动登录;在远程电脑上运行客户端时,需要在那台电脑完成登录。

提示登录过期?

DSH 用户回到插件设置重新点击“在浏览器登录”;其他 MCP 用户重新运行登录命令。登录后再提出需求,未提交的改动需要重新预览和确认。

已有课程无法修改?

已发布、尚未结束且未停用的课程可以调整课表,尚未开课也可以。已结束课程默认不修改;草稿需要先在佳速度官网发布。

删除或修改会影响哪些内容?

删除课程会连带删除其课表,请先核对范围。修改已被课表使用的训练时,按助手提示检查相关课程的训练关联。

客户端找不到 npx?

确认 Node.js 已安装,并重启客户端后重试。