Run Coach

跑步教练 — Garmin MCP 应用

将 Garmin 手表连接到 Claude Desktop 或 ChatGPT，探索交互式图表。

_{非官方产品，与 Garmin 无关，也未获其认可。Garmin 是 Garmin Ltd. 的商标。}

安装

Claude Desktop

1. 从 Releases 下载最新的 .mcpb 文件
2. 将文件拖入 Claude Desktop 进行安装
3. 向 Claude 询问任何有关 Garmin 数据的问题——首次使用时，Claude 会提示你登录

ChatGPT（桌面应用）

需要 Node.js 20+。

1. 在 ChatGPT 桌面应用中，打开 Settings → Plugins → Add marketplace
2. Source： chenhunghan/garmin-mcp-app（将 Git ref 和 sparse paths 留空）→ Add marketplace
3. 重启应用，打开 Plugins Directory，选择 Run Coach 市场并安装 Coach

也可以使用 Codex CLI：运行 codex plugin marketplace add chenhunghan/garmin-mcp-app，然后运行 codex plugin add garmin@garmin-mcp。

Coach 随后会显示在侧边栏中（每日简报和表现仪表盘），并在对话中显示为 Training Week 标签页；也可以直接询问“@Coach 我今天状态怎么样？”。它在你的电脑上运行，因此只能在桌面应用中使用。

其他 MCP 客户端（Cursor、VS Code、Claude Code、Codex CLI 等）

需要 Node.js 20+。将服务添加到客户端的 MCP 配置中：

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

也可以从命令行运行：claude mcp add garmin -- npx -y garmin-mcp-app（Claude Code），codex mcp add garmin -- npx -y garmin-mcp-app（Codex CLI）。

支持 MCP Apps 的客户端（例如 VS Code）会显示交互式图表和登录表单。其他客户端仍可将所有 Garmin 工具作为数据使用，但无法显示登录表单：请先通过 MCP Apps 客户端登录一次——令牌会保存在 ~/.garminconnect 中，并由你电脑上的所有客户端共享。

你可以做什么

向 Claude 询问健康、训练和健身相关问题——它会读取 Garmin 数据，并直接在对话中显示交互式图表。

• 开启新的一天——查看晨间简报：准备度、睡眠、HRV、身体电量和静息心率与个人基准的对比，以及 Claude 的建议
• 查看趋势——在 4 周到 1 年的时间范围内比较最多 4 项指标，并询问 Claude 有哪些变化
• 规划本周训练——Claude 根据你的数据制定一周训练计划，然后在 Garmin 日历中创建并安排训练
• 分析训练——查看每公里分段（即使跑步仅记录了单圈）、心率区间和训练效果
• 追踪体能——查看训练准备度、训练负荷、VO2 Max、比赛预测等 30 多项 Garmin 指标

由 Claude 为你的 Garmin 提供训练指导

应用会以你自己的基线为参照呈现数据；Claude 会读取数据并建议你该做什么。每个视图都有根据你的数据生成的 Ask Claude 问题，Claude 也知道你正在查看什么。

每日简报 — “我今天状态如何？”

表现仪表板 — “今年我的体能趋势如何？”

每周训练计划 — “为我安排本周的训练”（或使用 plan-training-week 提示词）

每公里分段数据 — “显示我上次跑步的分段数据”

_{截图使用内置演示模式（npm run dev:ui:demo）：展示的是虚构跑者，不含真实人物的数据。浅色和深色主题与 Claude Desktop 保持一致。}

你可以可视化的内容

绘制你的活动

可视化训练准备度

此应用不会存储或收集任何数据。 您的数据会直接在您的设备与 Garmin Connect API 之间传输，中间没有服务器。

git clone https://github.com/chenhunghan/garmin-mcp-app.git
cd garmin-mcp-app
npm install

git config --unset-all --local core.hooksPath
npm run prepare

npm run dev        # watch-build server + UI
npm run dev:ui     # standalone UI dev at localhost:5173
npm run test:lib   # run garmin-connect tests
npm run pack       # build + package .mcpb bundle

{
  "mcpServers": {
    "garmin-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/garmin-mcp-app/dist/index.js"]
    }
  }
}

type(optional-scope): description

免责声明

Run Coach 是一个独立的开源项目，与 Garmin Ltd. 或其子公司无关联，也未获得其认可或赞助。Garmin 和 Garmin Connect 是 Garmin Ltd. 或其子公司的商标；此处仅用于说明兼容性。此应用使用非官方的 Garmin Connect API，并通过您自己的账户访问。