Garmin Connect China MCP Server

Garmin Connect China MCP Server

Enables AI assistants to read Garmin health and fitness data from the Chinese version (garmin.cn) via MCP protocol.

Category
Visit Server

README

Garmin Connect China MCP Server

佳明中国大陆版 (garmin.cn) 的 MCP 数据读取服务。

通过 MCP (Model Context Protocol) 协议，让 AI 助手可以直接读取你的佳明健康和运动数据。

功能

类别 工具 说明
🏃 运动 get_activities 运动列表
get_activities_by_date 按日期查运动
get_activity 运动详情
get_activity_details 运动详细数据
get_activity_splits 每公里配速
get_activity_hr_zones 心率区间
get_activity_types 运动类型列表
get_last_activity 最近一次运动
📊 训练 get_training_status 训练状态/VO2 Max
get_training_readiness 训练准备度
👤 资料 get_profile 用户信息
get_devices 设备列表
get_primary_device 主训练设备
💤 睡眠 get_sleep 睡眠数据/得分/阶段
❤️ HRV get_hrv 心率变异性
😰 压力 get_stress 全天压力数据
🩸 血氧 get_spo2 SpO2 数据
🫁 呼吸 get_respiration 呼吸频率
🏅 其他 get_earned_badges 已获徽章
get_gear 装备数据

为什么需要这个？

佳明中国版 (garmin.cn) 的 API 架构和国际版 (garmin.com) 完全不同：

  • 国际版的 garminconnect Python 库不支持中国版
  • 中国版使用 /gc-api/ 服务端代理，而不是直接调 connectapi.garmin.cn
  • 登录使用 sso.garmin.cn/mobile/api/login（移动端 API）
  • 需要 curl_cffi 进行 Chrome TLS 指纹伪装来绕过 Cloudflare

安装

# 克隆仓库
git clone https://github.com/<your-username>/garmin-cn-mcp.git
cd garmin-cn-mcp

# 安装依赖
pip install -r requirements.txt

配置

在你的 MCP 客户端配置中添加：

{
  "mcpServers": {
    "garmin-cn": {
      "command": "python3",
      "args": ["/path/to/garmin_cn_mcp.py"],
      "env": {
        "GARMIN_CN_EMAIL": "your-garmin-email@example.com",
        "GARMIN_CN_PASSWORD": "your-password"
      }
    }
  }
}

Hermes Agent 配置

hermes mcp add garmin-cn -- python3 /path/to/garmin_cn_mcp.py

然后在 ~/.hermes/.env 中添加：

GARMIN_CN_EMAIL=your-garmin-email@example.com
GARMIN_CN_PASSWORD=your-password

使用示例

配置好后，AI 助手可以直接查询你的佳明数据：

  • "我昨天睡得怎么样？"
  • "最近一周的运动记录"
  • "今天的 HRV 和压力数据"
  • "我的训练状态和 VO2 Max"

技术细节

API 路径

数据类型 API 路径
运动列表 /gc-api/activitylist-service/activities/search/activities
运动详情 /gc-api/activity-service/activity/{id}
睡眠数据 /gc-api/wellness-service/wellness/dailySleepData?date=
HRV /gc-api/hrv-service/hrv/{date}
压力 /gc-api/wellness-service/wellness/dailyStress/{date}
血氧 /gc-api/wellness-service/wellness/daily/spo2/{date}
呼吸 /gc-api/wellness-service/wellness/daily/respiration/{date}

登录流程

  1. POST sso.garmin.cn/mobile/api/login → 获取 service ticket
  2. GET connect.garmin.cn/modern?ticket=... → 获取 JWT_WEB cookie + CSRF token
  3. 后续 API 调用通过 /gc-api/ 代理，携带 CSRF token

依赖

  • Python 3.10+
  • mcp (MCP SDK)
  • curl_cffi (Chrome TLS 指纹)

许可证

MIT License

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured