Garmin MCP 服务器
该模型上下文协议 (MCP) 服务器连接到 Garmin Connect 并将您的健身和健康数据公开给 Claude 和其他兼容 MCP 的客户端。
特征
- 列出最近的活动
- 获取详细活动信息
- 访问健康指标(步数、心率、睡眠)
- 查看身体成分数据
设置
- 在新环境中安装所需的包:
virtualenv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
- 使用您的 Garmin 凭据在项目根目录中创建一个
.env
文件:
GARMIN_EMAIL=your.email@example.com
GARMIN_PASSWORD=your-password
运行服务器
使用 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", // if you created a new environment this should be "<root_folder>/.venv/bin/python"
"args": ["<path to>/garmin_mcp/garmin_mcp_server.py"]
}
}
}
将该路径替换为服务器文件的绝对路径。
- 重启Claude桌面
使用 MCP 检查器
为了进行测试,您可以使用 MCP 检查器:
npx @modelcontextprotocol/inspector python /Users/adomingues/Documents/claude_filesystem/garmin_mcp/garmin_mcp_server.py
使用示例
一旦连接到 Claude,您可以提出以下问题:
- “显示我最近的活动”
- “我昨晚睡得怎么样?”
- “我昨天走了多少步?”
- “显示我最近一次跑步的详细信息”
安全说明
此服务器需要您在.env
文件中保存 Garmin Connect 凭据。请妥善保管此文件,切勿将其提交到代码库。
故障排除
如果您遇到登录问题:
- 验证
.env
文件中的凭据是否正确 - 检查 Garmin Connect 是否需要额外验证
- 确保 GarminConnect 软件包是最新的
对于其他问题,请检查 Claude Desktop 日志:
- macOS:
~/Library/Logs/Claude/mcp-server-garmin.log
- Windows:
%APPDATA%\Claude\logs\mcp-server-garmin.log