Garmin MCP

🚀 佳明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