garmin-sports-coach-mcp
Verifiedgarmin-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 连接器,用自然语言管理训练营的课程、训练与课表。
让助手帮你查看训练安排、整理训练库、把课程安排到具体日期。你只需要说清楚准备怎么练,就能用对话完成日常排课工作。
适合正在使用 佳速度(Garmin Sports) 带训练营的教练。这里管理的是训练营里的课程与课表;个人 Garmin Connect 日历可使用 dsh-plugin-garmin-connect。
由于训练营数据改动较多,改动前会需要你确认才会提交。
支持主流 Coding Agent 与 AI 工作台
DeepSeek Harness ·
WorkBuddy ·
千问办公 ·
ZCode ·
Claude Code ·
Codex ·
Cursor ·
Windsurf
支持 MCP 接入,也可在 DeepSeek Harness 中作为插件使用。
我的更多应用
| 图标 | 应用 | 一句话介绍 |
|---|---|---|
| WristTale | 在 Garmin、Apple、Android 手表上阅读 TXT 和 Markdown 电子书 | |
| JiaKe.app | 把 Garmin 截图做成精美宣传图 | |
| GameraSnap | 用佳明手表远程控制手机拍照/录像 | |
| WristAlbum | 在佳明手表上保存私人照片相册 | |
| WristPass | 把会员卡、票券装进手腕,随时出示 | |
| 2FA4G | 在佳明手表上保存离线两步验证码 |
这个插件做什么?
- 查看训练安排:找到你管理的训练营,查看课程、本周课表和训练详情。
- 创建训练:编排热身、间歇、恢复和放松,设置时间、距离、配速或心率目标。
- 安排新周期:在已有训练营里新建课程,一次安排整周或多周课表。
- 调整课表:增减训练日、更换训练内容、调整训练日期。
- 复用已有安排:复制课程,把整张课表的日期后移到下一个周期。
- 整理课程与训练库:查看、修改或删除内容,提交前先核对改动范围。
例如,你可以直接对助手说:
列出我管理的佳速度训练营,让我选一个,再看看它本周的课表。
把选中的课程复制为“下周训练”,所有日期后移 7 天,先给我预览。
帮我预览一节 6×800 米间歇训练,组间慢跑 2 分钟。
开始前先准备好
- 教练权限与训练营。 先在佳速度申请成为教练,取得相应权限,并在官网创建训练营,或确认已有训练营的管理权限。插件目前不能直接创建训练营。
- 同一个佳明账号。 登录插件时,使用管理上述训练营的账号。登录成功不代表已经有教练或管理权限。
- 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 已安装,并重启客户端后重试。