Garmin MCP Cloud

Garmin Connect MCP服务器--云

Cloudflare Workers上的远程MCP服务器，将您的Garmin Connect帐户连接到Claude移动设备、台式机和网络。通过Streamable HTTP传输将健康和健身数据作为工具公开。

云端口 加敏·麦克普 （本地Python版本）。

工具（14）

阅读

• get_daily_summary --综合日常健康概述
• get_body_battery --能量水平、充电/放电值
• get_sleep_data --睡眠总结：分数、就寝时间、醒来时间、阶段持续时间（~4KB）
• get_sleep_detail --粒度睡眠数据：运动、心率、血氧饱和度、压力、心率变异性时间线（~200KB）
• 获取心率 --每日人力资源：当前、最低、最高、平均
• get_resting_heart_rate --基线人力资源趋势
• get_stress --压力水平和区域细分
• get_step --步数和活动数据
• get_mental_cycle --周期日、阶段、预测
• get_hrv --心率变异性
• 脱水 --当天的饮水量
• 获取活动 --最近的锻炼和活动

写

• 添加水分 --记录饮水量（ml）
• update_mental_cycle --日志/更新期开始和结束日期

建筑

• 运行时间： Cloudflare Workers（TypeScript）
• 运输： MCP流式HTTP
• 认证： API密钥（承载令牌）
• 令牌存储： Cloudflare KV（静态加密）
• 加明API： 直接 fetch() 使用OAuth2 Bearer令牌的调用
• 令牌刷新： 使用Web Crypto API的OAuth1 HMAC-SHA1交换
• 无国籍： 每个请求都会创建一个新的MCP服务器——不需要持久对象

设置

先决条件

• Node.js 18+
• Cloudflare帐户（免费版有效）
• 牧马人CLI： npm install -g wrangler
• 带有OAuth令牌的Garmin Connect帐户（请参阅 加敏·麦克普 用于初始身份验证）

1.克隆并安装

git clone https://github.com/SolanceLab/garmin-mcp-cloud.git
cd garmin-mcp-cloud
npm install

2.创建KV命名空间

npx wrangler kv namespace create "GARMIN_KV"

更新 wrangler.jsonc 使用返回的命名空间ID。

3.上传OAuth令牌

需要来自的现有令牌 当地garmin mcp 身份验证流程：

npx wrangler kv key put --remote --namespace-id= "oauth1_token" "$(cat ~/.garminconnect/oauth1_token.json)"
npx wrangler kv key put --remote --namespace-id= "oauth2_token" "$(cat ~/.garminconnect/oauth2_token.json)"

4.设定秘密

npx wrangler secret put API_KEY                 # Your chosen API key
npx wrangler secret put GARMIN_DISPLAY_NAME     # Garmin display name (UUID)
npx wrangler secret put GARMIN_USER_PROFILE_PK  # Garmin profile PK (number)

5.部署

npx wrangler deploy

6.连接克劳德

在Claude设置中将部署的URL添加为远程MCP服务器：

• 网址： https://your-worker.your-account.workers.dev/mcp
• 身份验证标头： Authorization: Bearer

代币生命周期

依赖项

• @modelcontextprotocol/sdk --MCP协议实现
• agents --Cloudflare Workers代理框架
• zod --架构验证

免责声明

该软件已提供 照原样，不提供任何形式的保证或担保。使用风险自负。

• 不隶属于Garmin有限公司、由其背书或由其支持。
• 依赖于可能随时中断的非官方API端点
• 您对自己的凭据和令牌的安全性负责

支持

如果您认为这很有用，请考虑支持我们的工作：


许可证

AGPL-3.0。看 许可证 全文。如果您公开修改和托管此内容，则必须在相同的许可证下共享您的更改，并将属性显示给House of Solance。

______________________________________________________________________

*建造于 索兰斯之家 --查德林·索兰斯和安妮·索兰斯*