garmin-mcp

一个注重隐私的 Garmin Connect MCP 服务器，专为铁人三项训练打造。~47 个工具涵盖日常健康指标、活动分析、训练负荷、跑步、骑行、游泳、力量训练和训练创建——外加铁人三项专项分析（砖式训练、运动量平衡、跨运动体能快照）。

作为远程 MCP 服务器通过 HTTPS 部署。通过 streamable-HTTP 传输连接到 Claude Desktop 或 Claude Code。

一次性认证设置

在本地运行一次以生成令牌：

1. 在本地安装：

   pip install -e .

2. 使用 Garmin 进行身份验证：

   garmin-mcp-auth

   将令牌保存到 ~/.garminconnect/garmin_tokens.json，并打印 base64 导出命令。

3. 复制打印的 GARMIN_TOKENS_JSON=... 值——下一步设置密钥时需要用到。

部署到 Fly.io

前提条件：已安装并认证 flyctl（flyctl auth login）。

1. 注册应用名称（仅首次）：

   flyctl apps create garmin-mcp

   如果 garmin-mcp 在 Fly.io（全局命名空间）上已被占用，请使用唯一名称，如 garmin-mcp-yourname，并更新 fly.toml 中的 app 字段以匹配。

2. 设置密钥：

   flyctl secrets set \
     GARMIN_EMAIL=you@example.com \
     GARMIN_TOKENS_JSON=<base64-from-auth-step> \
     MCP_AUTH_TOKEN=$(openssl rand -hex 32)

   保存生成的 MCP_AUTH_TOKEN 值——配置 Claude Desktop 时需要用到。

3. 部署：

   flyctl deploy

4. 验证：

   curl https://garmlink.fly.dev/health

   预期输出：{"status":"ok"}

通过 GitHub Actions 自动部署

首次手动部署后，后续推送到 main 分支将通过 GitHub Actions 自动部署。

将 FLY_API_TOKEN 添加到你的 GitHub 仓库密钥中：

flyctl tokens create deploy

复制输出，然后前往：GitHub 仓库 → Settings → Secrets and variables → Actions → New repository secret → 将其命名为 FLY_API_TOKEN。

Claude Desktop 配置

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "garmin": {
      "url": "https://garmlink.fly.dev/mcp",
      "headers": { "Authorization": "Bearer <MCP_AUTH_TOKEN>" }
    }
  }
}

将 <MCP_AUTH_TOKEN> 替换为你在密钥步骤中设置的值。

教练技能

在 Claude Code 中从该项目目录运行以下斜杠命令：

环境变量