Garmin Connect MCP服务器

基于garth的Garmin Connect MCP服务器,提供健康、活动和设备数据管理功能。

  • by matin
  • Python
  • 本地部署
  • 65 星标
  • 更新于
在 GitHub 查看 matin/garth-mcp-server

使用说明

garth-mcp服务器

Garmin Connect MCP服务器基于 加思.

用法

安装

{
  "mcpServers": {
    "Garth - Garmin Connect": {
      "command": "uvx",
      "args": [
        "garth-mcp-server"
      ],
      "env": {
        "GARTH_TOKEN": "<output of `uvx garth login`>"
      }
    }
  }
}

确保路径 uvx 命令的作用域与MCP不同 使用与shell相同的PATH。在macOS上,它通常 /Users/{user}/.local/bin/uvx.

工具筛选

默认情况下,所有30个工具都是公开的。为了减小LLM使用的上下文大小, 您可以使用环境变量过滤工具。

仅启用特定工具(白名单)

{
  "mcpServers": {
    "Garth - Garmin Connect": {
      "command": "uvx",
      "args": ["garth-mcp-server"],
      "env": {
        "GARTH_TOKEN": "<token>",
        "GARTH_ENABLED_TOOLS": "get_activities,get_activity_details,daily_steps,nightly_sleep"
      }
    }
  }
}

禁用特定工具(黑名单)

"env": {
  "GARTH_TOKEN": "<token>",
  "GARTH_DISABLED_TOOLS": "get_gear,get_gear_stats,get_device_settings,get_connectapi_endpoint"
}

工具名称不区分大小写,逗号分隔。如果 GARTH_ENABLED_TOOLS 设置, GARTH_DISABLED_TOOLS 被忽略。

工具

健康与保健(使用Garth数据类)

  • user_profile -获取用户配置文件信息
  • user_settings -获取用户设置和首选项
  • nightly_sleep -通过可选的运动数据获取详细的睡眠数据
  • daily_sleep -获取每日睡眠摘要数据
  • daily_stress / weekly_stress -获取压力数据
  • daily_intensity_minutes / weekly_intensity_minutes -获取强度分钟数
  • daily_body_battery -获取车身电池数据
  • daily_hydration -获取水分数据
  • daily_steps / weekly_steps -获取步骤数据
  • daily_hrv / hrv_data -获取心率变异性数据

活动(使用Garmin Connect API)

  • get_activities -使用可选筛选器获取活动列表
  • get_activities_by_date -获取特定日期的活动
  • get_activity_details -获取详细的活动信息
  • get_activity_splits -获取活动圈数/分割数据
  • get_activity_weather -获取活动的天气数据

其他健康数据(使用Garmin Connect API)

  • get_body_composition -获取身体成分数据
  • get_respiration_data -获取呼吸数据
  • get_spo2_data -获取SpO2(血氧)数据
  • get_blood_pressure -获取血压读数

设备和齿轮(使用Garmin Connect API)

  • get_devices -获取已连接的设备
  • get_device_settings -获取设备设置
  • get_gear -获取装备信息
  • get_gear_stats -获取装备使用统计数据

实用工具

  • monthly_activity_summary -获取月度活动概览
  • snapshot -获取日期范围的快照数据
  • get_connectapi_endpoint -直接访问任何Garmin Connect API端点