Garmin China MCP

Garmin Connect 中国版 MCP サーバー — 55 個のツール、トレーニングデータ、回復指標、天候熱ストレス評価、健康データ集約をカバー。

WorkBuddy、Claude Desktop など、MCP（Model Context Protocol）をサポートする任意のクライアントに対応。

インストール

pip install garmin-china

または uv を使用（推奨）：

uv pip install garmin-china

Related MCP server: Garmin Connect China MCP Server

認証

初回使用時は Garmin Connect 中国版にログインしてトークンを取得：

# PowerShell
$env:GARMIN_EMAIL='你的邮箱@qq.com'
$env:GARMIN_PASSWORD='你的佳明密码'
garmin-china-auth

# Bash
export GARMIN_EMAIL='你的邮箱@qq.com'
export GARMIN_PASSWORD='你的佳明密码'
garmin-china-auth

トークンは ~/.garmin-china/tokens/ に保存されます。GARMIN_TOKEN_DIR 環境変数でパスを上書き可能。

⚠️ 認証は必ず通常権限のターミナルで実行してください。 管理者ターミナルで実行するとトークンファイルの所有者が Administrators になり、通常プロセスが読み取れなくなります。

MCP クライアントの設定

WorkBuddy

~/.workbuddy/mcp.json を編集（.mcp.json ではないことに注意）：

{
  "mcpServers": {
    "garmin": {
      "command": "garmin-china",
      "disabled": false
    }
  }
}

Claude Desktop

claude_desktop_config.json を編集：

{
  "mcpServers": {
    "garmin": {
      "command": "garmin-china"
    }
  }
}

uvx を使用（インストール不要）

{
  "mcpServers": {
    "garmin": {
      "command": "uvx",
      "args": ["garmin-china"]
    }
  }
}

設定後、クライアントを再起動し、コネクタ管理で garmin サーバーを信頼してください。

ツール一覧（55 個）

トレーニングとアクティビティ（20）

• activities / last_activity / get_activity — アクティビティ一覧と詳細

• activity_splits / activity_split_summaries / activity_typed_splits — セグメントデータ

• activity_hr_in_timezones / get_activity_gear — 心拍数タイムゾーンと装備

• count_activities / get_activity_types — 統計とタイプ

• download_workout / get_workouts / get_workout_templates — トレーニング計画

• get_activity_weather / get_activity_exercise_sets — 天気とセット数

• steps_data / daily_steps / get_weekly_steps — 歩数

• get_activities_fordate — 日付でアクティビティを検索

回復と健康（18）

• user_summary / daily_summary — 日次サマリー

• sleep — 睡眠分析

• hrv / hr_intraday / resting_hr — 心拍変動と心拍数

• body_battery — ボディバッテリー

• stress / get_weekly_stress — ストレス

• spo2 / respiration — 血中酸素と呼吸

• hydration — 水分補給

• weight — 体重

• training_status / training_readiness — トレーニング状態と準備

• vo2max / race_predictions — 最大酸素摂取量とレース予測

• get_goals / personal_record — 目標と自己記録

• endurance_score / hill_score / lactate_threshold / get_fitness_age — 体力指標

週報とトレンド（10）

• weekly_health / stats_trend / progress_summary — 週報とトレンド

• weekly_intensity_minutes — 週間強度時間

• user_summary / garmin_weekly_health — 健康データ集約

天気と熱ストレス（7）

• weather_now — リアルタイム天気 + ランニング熱ストレス評価 + ペース減衰

• weather_forecast — 時間ごとの予報

• weather_at — 指定時刻の過去実況

• weather_log — 気象ログアーカイブ（24時間遡及）

• weather_pace — ペース熱補正計算機

• garmin_run_conditions — ランニングと気候の統合評価（等価ペース含む）

• garmin_weekly_health — 週間健康データ集約

天気ログアーカイブ（オプション）

公式の時間ごとの実況は24時間しか遡れません。Windows タスクスケジューラを登録して自動アーカイブ：

garmin-china-weather --install    # 注册（每 6 小时归档一次）
garmin-china-weather --uninstall  # 卸载

ログは ~/.garmin-china/weather-log/ に保存されます。

自己チェック

garmin-china-selftest            # 检查协议与工具注册
garmin-china-selftest --call     # 额外调用真实数据验证

注意事項

• garminconnect を 0.3.x にアップグレードしないでください — 中国版の DI トークンがすべて失敗します。0.2.40 に固定されています。

• 認証は通常権限のターミナルで行ってください — 管理者ターミナルではトークンファイルの権限問題が発生します。

• Garmin 中国版（garmin.cn）のみ対応 — 国際版 Garmin Connect では使用できません。

技術スタック

• Python ≥ 3.11

• garminconnect 0.2.40 + garth 0.6.3（OAuth 認証）

• mcp ≥ 1.29.0（Model Context Protocol）

• 天気データソース：中国気象局公共気象サービスセンター（weather.com.cn）

ライセンス

MIT