JinDaGe - garmin-mcp MCP Details

article

README

🚀 佳明MCP服务器

佳明MCP服务器通过连接佳明Connect，实现将您的健身和健康数据分享给Claude及其他兼容客户端，让您能更便捷地获取和分析自身的健康信息。

🚀 快速开始

佳明MCP服务器可以连接佳明Connect，将您的健身和健康数据分享给Claude和其他兼容的客户端。以下是使用该服务器的详细步骤。

✨ 主要特性

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

📦 安装指南

在新环境中安装所需的包：

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

在项目根目录中创建一个.env文件，输入您的佳明凭证：

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

💻 使用示例

基础用法

一旦在Claude中连接成功，您可以用以下问题进行询问：

"显示我的最近活动"
"昨晚的睡眠情况如何？"
"昨天走了多少步？"
"显示我最新跑步的详细信息"

运行服务器

与Claude Desktop一起使用

在Claude Desktop中创建配置：编辑您的Claude Desktop配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json 添加此服务器配置：

{
  "mcpServers": {
    "garmin": {
      "command": "python", // 如果您创建了新环境，这应该是 "<根目录>/.venv/bin/python"
      "args": ["<路径>/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

⚠️ 安全与故障排除

安全注意事项

⚠️ 重要提示

此服务器需要您的佳明Connect凭证在.env文件中。请保持此文件安全，切勿将其提交到版本控制系统。

故障排除

如果遇到登录问题：

确认.env文件中的凭证是否正确
检查佳明Connect是否需要额外的验证
确保garminconnect包是最新版本

对于其他问题，请查看Claude Desktop日志：

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

garmin-mcp