Garmin Connect API客户端

一个用于消费Garmin Connect HTTP API的MCP服务器客户端,提供健身数据管理、活动跟踪和健康监测功能。

  • by Mart1M
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Mart1M/garmin-connect-mcp-client

使用说明

Garmin Connect MCP客户端

使用Garmin Connect HTTP API的MCP服务器客户端。

安装

npm install -g @mart1/garmin-connect-mcp-client

或者与npx一起使用:

npx @mart1/garmin-connect-mcp-client

配置

设置环境变量:

export GARMIN_EMAIL="your@email.com"
export GARMIN_PASSWORD="your_password"

使用Claude Desktop

添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "garmin-connect": {
      "command": "npx",
      "args": ["-y", "@mart1/garmin-connect-mcp-client"],
      "env": {
        "GARMIN_EMAIL": "your@email.com",
        "GARMIN_PASSWORD": "your_password"
      }
    }
  }
}

可用工具(25个工具)

锻炼工具(4个工具)

  • upload_workout -将训练上传到Garmin Connect

    • 参数: workout_json (必填), auto_clean (可选,默认值:true)
  • get_workouts -获取锻炼列表

    • 参数: start (可选,默认值:0), limit (可选,默认值:10)
  • get_workout_by_id -按ID获取锻炼

    • 参数: workout_id (必填)
  • 准备锻炼 -通过清洁来准备上传的锻炼

    • 参数: workout_json (必填)

活动工具(6个工具)

  • 获取活动 -获取活动列表

    • 参数: start (可选,默认值:0), limit (可选,默认值:20), activitytype (可选)
  • get_last_活动 -获取最新活动

    • 参数:无
  • 获取活动_日期 -获取日期范围内的活动

    • 参数: startdate (必填,YYYY-MM-DD), enddate (必填,YYYY-MM-DD), activitytype (可选), sortorder (可选:“asc”或“desc”)
  • get_activity -按ID获取特定活动

    • 参数: activity_id (必填)
  • get_activity_details -通过GPS追踪获取全面的活动详情

    • 参数: activity_id (必填), maxchart (可选,默认值:2000), maxpoly (可选,默认值:4000)
  • 获取活动订单 -获取特定日期的活动

    • 参数: date (必填,YYYY-MM-DD)

健康数据工具(11个工具)

  • get_daily_summary -获取每日健康和活动摘要

    • 参数: date (可选,YYYY-MM-DD)
  • 获取心率数据 -获取心率数据

    • 参数: date (必填,YYYY-MM-DD)
  • get_sleep_data -获取睡眠数据

    • 参数: date (必填,YYYY-MM-DD)
  • get_stress_data -获取压力数据

    • 参数: date (必填,YYYY-MM-DD)
  • get_body_battery -获取车身电池电量

    • 参数: startdate (必填,YYYY-MM-DD), enddate (可选,YYYY-MM-DD)
  • get_resting_heart_rate -获得静息心率

    • 参数: date (必填,YYYY-MM-DD)
  • get_hrv_data -获取心率变异性(HRV)数据

    • 参数: date (必填,YYYY-MM-DD)
  • get_training_ready -获取训练准备得分

    • 参数: date (必填,YYYY-MM-DD)
  • get_steps_data -获取步骤数据

    • 参数: date (必填,YYYY-MM-DD)
  • 获取呼吸数据 -获取呼吸数据

    • 参数: date (必填,YYYY-MM-DD)
  • get_spo2_data -获取SpO2(血氧饱和度)数据

    • 参数: date (必填,YYYY-MM-DD)

绩效指标工具(4个工具)

  • get_max_metrics -获得最大摄氧量和健身年龄

    • 参数: date (必填,YYYY-MM-DD)
  • get_training_status -获取训练状态和负载

    • 参数: date (必填,YYYY-MM-DD)
  • get_endance_score -获取耐力得分

    • 参数: startdate (必填,YYYY-MM-DD), enddate (可选,YYYY-MM-DD)
  • get_race_预测 -获取比赛时间预测

    • 参数: startdate (可选), enddate (可选), prediction_type (可选:“最新”或“每日”)