Garmin Workouts MCP

Garmin Workouts MCP

garmin-workouts-mcp 是一个用于 Garmin Connect 训练的独立 MCP 服务。

它旨在作为专用扩展，为需要对 Garmin 训练数据进行更多结构化处理的工作流提供支持，尤其是力量训练。

此项目打包为 stdio MCP 服务，可发布为 OCI 镜像，供 MCP 注册表和 Glama 部署。它不是独立的公共 HTTP MCP 端点。

新增功能

• 支持 Garmin 力量训练步骤的 reps 结束条件。
• 支持通过显式 Garmin 枚举值或易记别名设置运动元数据。
• 新增 preview_workout_payload，可在上传前检查数据。
• 新增 validate_workout，用于提前发现架构和映射错误。
• 新增 resolve_supported_strength_exercise，可快速检查映射。
• 新增 get_workout_input_schema，用于机器可读的客户端集成。
• 将 walking 纳入支持的运动类型，并同步更新提示词／架构。
• 保留熟悉的列表、获取、删除、安排、日历和活动工具。

环境

基于 Garmin 的工具会在调用时按需进行身份验证：

• 身份验证方式：GARMIN_EMAIL 和 GARMIN_PASSWORD

服务可以在没有凭据的情况下启动。不与 Garmin 通信的工具（例如数据预览和架构检查）仍可在没有密钥的情况下使用。

训练输入

上传和预览工具接受如下结构的 JSON 对象：

{
  "name": "Upper Day",
  "type": "strength",
  "steps": [
    {
      "stepType": "warmup",
      "endConditionType": "lap.button",
      "stepDescription": "General warm-up"
    },
    {
      "stepType": "interval",
      "exercise": "incline db press",
      "endConditionType": "reps",
      "stepReps": 8,
      "stepDescription": "8-10 reps"
    },
    {
      "stepType": "rest",
      "endConditionType": "time",
      "stepDuration": 120
    }
  ]
}

对于力量训练动作，可以传入易记别名：

{ "exercise": "t bar row" }

也可以传入显式 Garmin 枚举值：

{
  "exercise": {
    "category": "ROW",
    "exerciseName": "T_BAR_ROW"
  }
}

你也可以通过 get_workout_input_schema 以编程方式检查接受的结构，或使用 resolve_supported_strength_exercise 查询可能的 Garmin 力量训练映射。

开发

在 Docker Compose 中运行测试：

docker compose run --rm tests

构建运行时镜像：

docker build -t garmin-workouts-mcp:local .

在没有 Garmin 凭据的情况下，对 stdio 服务启动进行冒烟测试：

python - <<'PY'
import subprocess

proc = subprocess.Popen(
    ["bash", "-lc", "tail -f /dev/null | docker run --rm -i garmin-workouts-mcp:local"]
)
try:
    proc.wait(timeout=5)
    print(f"container exited early with code {proc.returncode}")
finally:
    if proc.poll() is None:
        proc.terminate()
        proc.wait()
        print("container stayed up for 5 seconds")
PY

发布

预期的 OCI 镜像位置：

ghcr.io/pranciskus/garmin-workouts-mcp

注册表元数据位于 server.json 中。OCI 镜像包含所需标签：

io.modelcontextprotocol.server.name=io.github.pranciskus/garmin-workouts-mcp

Glama 所有权元数据位于 glama.json 中。该文件声明了可认领和管理 Glama 条目的 GitHub 维护者账号。