返回 MCP 目录
public公开dns本地运行

Garmin Connect

一个用于与Garmin Connect API交互的服务器项目

article

README

🚀 佳明连接 MCP 服务器

该项目搭建了一个可与佳明连接 API 进行交互的服务器。借助此服务器,用户能够对自身的佳明数据(如锻炼记录、健康指标等)进行管理。

🚀 快速开始

🔍 先决条件

  • Python 3.x
  • 需通过 uv sync 安装必要的 Python 包
  • 拥有一个佳明连接账户
  • 借助 Python 佳明连接包与佳明连接 API 交互,可参考:https://github.com/cyberjunky/python-garminconnect

⚙️ 环境变量

需在根目录下,依据 .env_template 文件创建一个 .env 文件,并设置以下变量:

  • GARMIN_EMAIL
  • GARMIN_PASSWORD

🪙 生成佳明连接令牌

python example.py

🧐 使用 MCP 检查器

mcp dev garmin_mcp_server.py

📝 在 Claude Desktop 中注册 MCP 服务器

mcp install garmin_mcp_server.py

🚀 运行服务器

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端