Garmin MCP 服务器

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

功能

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

设置

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

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

1. 在项目根目录下创建一个包含您的Garmin凭据的.env文件：

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

运行服务器

使用Claude桌面版

1. 在Claude桌面版中创建配置：

编辑您的Claude桌面版配置文件：

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

添加此服务器配置：

json
{
"mcpServers": {
"garmin": {
"command": "python", // 如果您创建了一个新的环境，这里应该是 "<root_folder>/.venv/bin/python"
"args": ["/garmin_mcp/garmin_mcp_server.py"]
}
}
}

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

1. 重启Claude桌面版

使用MCP Inspector

为了测试，您可以使用MCP Inspector：

bash
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桌面版的日志：

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