Garmin China MCP

Сервер MCP для Garmin Connect (Китай) — 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