Garmin China MCP

Garmin Connect China MCP-Server – 55 Tools, die Trainingsdaten, Erholungsindikatoren, Bewertung von Hitzestress durch Wetter und Gesundheitsaggregation abdecken.

Kompatibel mit WorkBuddy, Claude Desktop und jedem anderen Client, der MCP (Model Context Protocol) unterstützt.

Installation

pip install garmin-china

Oder verwenden Sie uv (empfohlen):

uv pip install garmin-china

Related MCP server: Garmin Connect China MCP Server

Authentifizierung

Bei der ersten Nutzung müssen Sie sich bei Garmin Connect China anmelden, um ein Token zu erhalten:

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

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

Das Token wird unter ~/.garmin-china/tokens/ gespeichert. Der Pfad kann mit der Umgebungsvariable GARMIN_TOKEN_DIR überschrieben werden.

⚠️ Führen Sie die Authentifizierung unbedingt in einem Terminal mit normalen Berechtigungen aus. Ein Administratoren-Terminal setzt den Besitzer der Token-Datei auf Administratoren, sodass normale Prozesse sie nicht lesen können.

MCP-Client konfigurieren

WorkBuddy

Bearbeiten Sie ~/.workbuddy/mcp.json (Achtung: nicht .mcp.json):

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

Claude Desktop

Bearbeiten Sie claude_desktop_config.json:

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

Verwendung von uvx (ohne Installation)

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

Nach der Konfiguration starten Sie den Client neu und vertrauen dem Garmin-Server in der Connector-Verwaltung.

Tool-Liste (55)

Training & Aktivitäten (20)

• activities / last_activity / get_activity – Aktivitätsliste und Details

• activity_splits / activity_split_summaries / activity_typed_splits – Segmentdaten

• activity_hr_in_timezones / get_activity_gear – Herzfrequenz-Zeitzonen und Ausrüstung

• count_activities / get_activity_types – Statistiken und Typen

• download_workout / get_workouts / get_workout_templates – Trainingspläne

• get_activity_weather / get_activity_exercise_sets – Wetter und Satzzahlen

• steps_data / daily_steps / get_weekly_steps – Schritte

• get_activities_fordate – Aktivitäten nach Datum abfragen

Erholung & Gesundheit (18)

• user_summary / daily_summary – Tägliche Zusammenfassung

• sleep – Schlafanalyse

• hrv / hr_intraday / resting_hr – Herzfrequenzvariabilität und Herzfrequenz

• body_battery – Körperbatterie

• stress / get_weekly_stress – Stress

• spo2 / respiration – Blutsauerstoff und Atmung

• hydration – Flüssigkeitszufuhr

• weight – Gewicht

• training_status / training_readiness – Trainingsstatus und -bereitschaft

• vo2max / race_predictions – Maximale Sauerstoffaufnahme und Wettkampfvorhersagen

• get_goals / personal_record – Ziele und persönliche Rekorde

• endurance_score / hill_score / lactate_threshold / get_fitness_age – Fitnessindikatoren

Wochenberichte & Trends (10)

• weekly_health / stats_trend / progress_summary – Wochenbericht und Trends

• weekly_intensity_minutes – Wöchentliche Intensitätsminuten

• user_summary / garmin_weekly_health – Gesundheitsaggregation

Wetter & Hitzestress (7)

• weather_now – Echtzeitwetter + Bewertung von Hitzestress beim Laufen + Tempoabfall

• weather_forecast – Stündliche Vorhersage

• weather_at – Historische Daten zu einem bestimmten Zeitpunkt

• weather_log – Wetterprotokollarchiv (24h Rückblick)

• weather_pace – Tempo-Hitzekorrektur-Rechner

• garmin_run_conditions – Kombinierte Bewertung von Laufen und Klima (mit äquivalentem Tempo)

• garmin_weekly_health – Wöchentliche Gesundheitsaggregation

Wetterprotokollarchiv (optional)

Die offiziellen stündlichen Echtzeitdaten reichen nur 24 Stunden zurück. Registrieren Sie eine Windows-Aufgabe zur automatischen Archivierung:

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

Die Protokolle werden unter ~/.garmin-china/weather-log/ gespeichert.

Selbsttest

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

Einschränkungen

• Aktualisieren Sie garminconnect nicht auf 0.3.x – Die DI-Token für die China-Region schlagen alle fehl. Wurde auf 0.2.40 festgelegt.

• Authentifizierung muss in einem Terminal mit normalen Berechtigungen erfolgen – Ein Administratoren-Terminal führt zu Berechtigungsproblemen mit der Token-Datei.

• Unterstützt nur Garmin China (garmin.cn) – Nicht kompatibel mit der internationalen Version von Garmin Connect.

Technologie-Stack

• Python ≥ 3.11

• garminconnect 0.2.40 + garth 0.6.3 (OAuth-Authentifizierung)

• mcp ≥ 1.29.0 (Model Context Protocol)

• Wetterdatenquelle: Öffentlicher Wetterdienst der Chinesischen Meteorologischen Verwaltung (weather.com.cn)

Lizenz

MIT