# Taxuspt
## 基本信息
- Slug: `taxuspt-garmin_mcp`
- Source: modelscope
- Publisher: @Taxuspt/garmin_mcp
- Categories: fitness-tracking / health-and-wellness / data-platforms
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@Taxuspt/garmin_mcp
## 简介
暂无描述。
## MCP Server 详情

# Garmin MCP 服务器

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

## 功能

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

## 设置

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

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


2. 在项目根目录下创建一个包含您的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": ["<path to>/garmin_mcp/garmin_mcp_server.py"]
    }
  }
}


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

2. 重启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`