Garmin MCP 服务器

此模型上下文协议 (MCP) 服务器连接到 Garmin Connect，并将您的健身和健康数据暴露给 Claude 和其他 MCP 兼容的客户端。

功能

• 列出最近的活动
• 获取详细的活动信息
• 访问健康指标（步数、心率、睡眠）
• 查看身体成分数据

设置

1. 在新环境中安装所需的软件包：

virtualenv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

2. 在项目根目录中创建一个 .env 文件，其中包含您的 Garmin 凭据：

GARMIN_EMAIL=your.email@example.com
GARMIN_PASSWORD=your-password

运行服务器

使用 Claude Desktop

1. 在 Claude Desktop 中创建一个配置：

编辑您的 Claude Desktop 配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

添加此服务器配置：

{
  "mcpServers": {
    "garmin": {
      "command": "python", // 如果您创建了一个新环境，则应为 "<root_folder>/.venv/bin/python"
      "args": ["<path to>/garmin_mcp/garmin_mcp_server.py"]
    }
  }
}

将路径替换为服务器文件的绝对路径。

2. 重启 Claude Desktop

使用 MCP Inspector

对于测试，您可以使用 MCP Inspector：

npx @modelcontextprotocol/inspector python /Users/adomingues/Documents/claude_filesystem/garmin_mcp/garmin_mcp_server.py

使用示例

在 Claude 中连接后，您可以提出如下问题：

• "显示我最近的活动"
• "我昨晚的睡眠怎么样？"
• "我昨天走了多少步？"
• "显示我最近一次跑步的详细信息"

安全提示

此服务器需要在 .env 文件中提供您的 Garmin Connect 凭据。请确保此文件安全，并且永远不要将其提交到存储库。

故障排除

如果遇到登录问题：

1. 验证 .env 文件中的凭据是否正确
2. 检查 Garmin Connect 是否需要额外的验证
3. 确保 garminconnect 包是最新的

对于其他问题，请查看 Claude Desktop 日志，位置如下：

• macOS: ~/Library/Logs/Claude/mcp-server-garmin.log
• Windows: %APPDATA%\Claude\logs\mcp-server-garmin.log