Garmin Connect MCP 服务器使用说明

项目简介

Garmin Connect MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，它将您的 Garmin Connect 账户数据转换为可以通过 MCP 协议访问的资源和工具，从而允许大型语言模型 (LLM) 安全、便捷地获取和利用您的个人健康与运动数据。

主要功能点

数据访问工具: 提供多种工具，用于获取 Garmin Connect 平台上的各类数据，包括：
- 活动数据: 查询和获取您的运动活动记录。
- 睡眠数据: 获取每日或指定日期范围内的睡眠分析数据。
- 心率数据: 查询特定日期的心率信息。
- 身体电量数据: 获取身体电量 (Body Battery) 变化数据。
- 压力数据: 查询每日压力水平数据。
- 步数数据: 获取每日步数统计。
个性化问候资源: 提供一个简单的资源示例，用于演示 MCP 资源的概念。

安装步骤

环境准备: 确保您的系统已安装 Python 3.x。
安装依赖: 使用 'uv sync' 命令安装项目所需的 Python 包。如果您没有 'uv'，请先安装 'pip install uv'，然后运行 'uv sync'。
配置 Garmin 账户:
- 复制 '.env_template' 文件并重命名为 '.env'。
- 编辑 '.env' 文件，填入您的 Garmin Connect 账户的邮箱 ('GARMIN_EMAIL') 和密码 ('GARMIN_PASSWORD')。
生成 Garmin Connect Token: 运行 'python example.py' 命令，根据提示操作，生成用于访问 Garmin Connect API 的 token 文件。这将会在您的用户目录下创建 '.garminconnect' 文件夹用于存储 token 信息，以便后续服务器免密登录。

服务器配置

要将 Garmin Connect MCP 服务器配置到 MCP 客户端（例如 Claude Desktop），您需要提供以下 JSON 格式的配置信息。请注意，以下配置信息假设您在项目根目录下启动服务器。

{
  "server name": "Garmin Connect MCP Server",
  "command": "python",
  "args": ["garmin_mcp_server.py"]
}

配置参数说明:

'server name': 服务器的名称，可以自定义，例如 "Garmin Connect MCP Server"。
'command': 启动服务器的命令，这里使用 'python' 解释器。
'args': 启动命令的参数，指定服务器脚本的文件名 'garmin_mcp_server.py'。

将以上 JSON 配置信息填入您的 MCP 客户端，客户端将使用配置的命令和参数启动 Garmin Connect MCP 服务器并建立连接。

基本使用方法

启动服务器: 在 MCP 客户端中配置并启动 Garmin Connect MCP 服务器。
客户端交互: 使用 MCP 客户端向服务器发送请求，调用预定义的工具和资源。例如，您可以调用 'fetch_sleep_data' 工具并传入日期参数来获取指定日期的睡眠数据。或者访问 'greeting://YourName' 资源来获取个性化的问候语。

示例工具调用 (假设使用 MCP Inspector):

工具名称: 'fetch_sleep_data' 参数:

{
  "date": "2024-01-01"
}

示例资源访问 (假设使用 MCP Inspector):

资源 URI: 'greeting://Claude'

请参考 MCP 客户端的文档，了解如何配置和使用 MCP 服务器，以及如何调用工具和访问资源。

关键词