🚀 佳明MCP服务器

佳明MCP服务器可连接到佳明Connect平台，将您的健身与健康数据分享给Claude及其他兼容客户端，让您能更便捷地获取和分析个人健康信息。

🚀 快速开始

本服务器能连接佳明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

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", // 如果您创建了新环境，这应该是 "<根目录>/.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文件中。请保持此文件安全，切勿将其提交到版本控制系统。

🛠️ 故障排除

登录问题

如果遇到登录问题：

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

查看日志

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

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