Garmin China MCP

Servidor MCP de Garmin Connect China — 55 herramientas que cubren datos de entrenamiento, métricas de recuperación, evaluación de estrés térmico por clima y agregación de salud.

Compatible con WorkBuddy, Claude Desktop y cualquier otro cliente que admita MCP (Model Context Protocol).

Instalación

pip install garmin-china

O usa uv (recomendado):

uv pip install garmin-china

Related MCP server: Garmin Connect China MCP Server

Autenticación

La primera vez que lo uses, inicia sesión en Garmin Connect China para obtener un token:

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

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

El token se guarda en ~/.garmin-china/tokens/. Se puede sobrescribir la ruta con la variable de entorno GARMIN_TOKEN_DIR.

⚠️ Ejecuta la autenticación en una terminal con permisos normales. Una terminal de administrador hará que el propietario del archivo token sea Administrators, y los procesos normales no podrán leerlo.

Configurar el cliente MCP

WorkBuddy

Edita ~/.workbuddy/mcp.json (nota: no es .mcp.json):

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

Claude Desktop

Edita claude_desktop_config.json:

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

Usar uvx (sin instalación)

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

Después de configurar, reinicia el cliente y confía en el servidor garmin en la gestión de conectores.

Lista de herramientas (55)

Entrenamiento y actividad (20)

• activities / last_activity / get_activity — Lista y detalles de actividades

• activity_splits / activity_split_summaries / activity_typed_splits — Datos de segmentos

• activity_hr_in_timezones / get_activity_gear — Zonas horarias de frecuencia cardíaca y equipo

• count_activities / get_activity_types — Estadísticas y tipos

• download_workout / get_workouts / get_workout_templates — Planes de entrenamiento

• get_activity_weather / get_activity_exercise_sets — Clima y series de ejercicios

• steps_data / daily_steps / get_weekly_steps — Pasos

• get_activities_fordate — Consultar actividades por fecha

Recuperación y salud (18)

• user_summary / daily_summary — Resumen diario

• sleep — Análisis del sueño

• hrv / hr_intraday / resting_hr — Variabilidad de la frecuencia cardíaca y frecuencia cardíaca

• body_battery — Batería corporal

• stress / get_weekly_stress — Estrés

• spo2 / respiration — Oxígeno en sangre y respiración

• hydration — Hidratación

• weight — Peso

• training_status / training_readiness — Estado de entrenamiento y preparación

• vo2max / race_predictions — VO2 máx. y predicciones de carrera

• get_goals / personal_record — Objetivos y récords personales

• endurance_score / hill_score / lactate_threshold / get_fitness_age — Indicadores de condición física

Informes semanales y tendencias (10)

• weekly_health / stats_trend / progress_summary — Informes semanales y tendencias

• weekly_intensity_minutes — Minutos de intensidad semanal

• user_summary / garmin_weekly_health — Agregación de salud

Clima y estrés térmico (7)

• weather_now — Clima en tiempo real + evaluación de estrés térmico al correr + degradación del ritmo

• weather_forecast — Pronóstico por hora

• weather_at — Condiciones históricas en un momento específico

• weather_log — Archivo de registro meteorológico (retrospectiva de 24 h)

• weather_pace — Calculadora de corrección de ritmo por calor

• garmin_run_conditions — Evaluación combinada de carrera y clima (incluye ritmo equivalente)

• garmin_weekly_health — Agregación de salud semanal

Archivo de registro meteorológico (opcional)

El registro oficial por hora solo retrocede 24 horas. Registra una tarea programada de Windows para archivar automáticamente:

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

Los registros se guardan en ~/.garmin-china/weather-log/.

Autocomprobación

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

Líneas rojas

• No actualices garminconnect a 0.3.x — Todos los tokens DI de China fallarán. Bloqueado en 0.2.40.

• La autenticación debe realizarse en una terminal con permisos normales — Una terminal de administrador causará problemas de permisos en el archivo token.

• Solo compatible con Garmin China (garmin.cn) — No funciona con la versión internacional de Garmin Connect.

Stack tecnológico

• Python ≥ 3.11

• garminconnect 0.2.40 + garth 0.6.3 (autenticación OAuth)

• mcp ≥ 1.29.0 (Model Context Protocol)

• Fuente de datos meteorológicos: Centro de Servicios Meteorológicos Públicos de la Administración Meteorológica de China (weather.com.cn)

Licencia

MIT