Garmin MCP Server
2025.03.11
6
Python健康与健身健康与健身
Garmin MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于连接 Garmin Connect 并暴露用户的健康和健身数据给 Claude 和其他兼容 MCP 的客户端。它提供了访问用户活动、健康指标和身体成分数据的功能。
View on GitHub
Overview
基本能力
产品定位
Garmin MCP Server 是一个健康和健身数据的中介服务，允许用户通过 MCP 协议访问其 Garmin Connect 账户中的健康和健身数据。
核心功能
- 列出最近的活动
- 获取详细的活动信息
- 访问健康指标（步数、心率、睡眠）
- 查看身体成分数据
适用场景
- 用户希望在其他应用中查看其 Garmin 健康数据
- 开发者需要集成 Garmin 健康数据到自己的应用中
- 数据分析师需要访问用户的健康和健身数据进行研究
工具列表
- MCP Inspector：用于测试 MCP 服务器的工具，可以检查服务器的响应和数据格式。
常见问题解答
- 登录问题：检查
.env文件中的凭证是否正确，确保 Garmin Connect 不需要额外的验证。 - 其他问题：查看 Claude Desktop 的日志文件以获取更多信息。
使用教程
使用依赖
- 创建并激活虚拟环境：
virtualenv .venv
source .venv/bin/activate
- 安装依赖包：
python -m pip install -r requirements.txt
安装教程
- 在项目根目录创建
.env文件并填入 Garmin 凭证：
[email protected]
GARMIN_PASSWORD=your-password
- 配置 Claude Desktop 以使用该服务器：
- 编辑配置文件
claude_desktop_config.json - 添加服务器配置：
{
"mcpServers": {
"garmin": {
"command": "python",
"args": ["<path to>/garmin_mcp/garmin_mcp_server.py"]
}
}
}
- 重启 Claude Desktop
调试方式
使用 MCP Inspector 进行测试：
npx @modelcontextprotocol/inspector python /path/to/garmin_mcp_server.py