8sleep MCP

🚀 Eight Sleep MCP

Eight Sleep MCP 是一個用於訪問 Eight Sleep 枕數據的 Model Context Protocol (MCP) 服務器，它能幫助用戶便捷地獲取和管理相關睡眠數據。

🚀 快速開始

在使用 Eight Sleep MCP 前，您需要完成安裝和配置，下面將為您詳細介紹。

📦 安裝指南

先決條件

• Node.js（v16+）
• Eight Sleep 賬戶

安裝步驟

1. 克隆倉庫。
2. 運行以下命令進行依賴安裝和項目構建：

npm install
npm run build

配置指南

獲取您的用戶 ID

您需要獲取一次 Eight Sleep 的用戶 ID 並添加到配置中，這樣可以避免客戶端在每次請求時都通過電子郵件/密碼進行身份驗證。您有兩種獲取方式：

選項 1：直接 API 調用

1. 執行以下 curl 命令：

curl -X POST https://client-api.8slp.net/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"your_email","password":"your_password"}'

2. 將響應中獲取的用戶 ID 添加到配置中。

選項 2：使用 MCP 客戶端

1. 首先設置不帶用戶 ID 的 .env 文件：

EIGHT_SLEEP_EMAIL=your_email
EIGHT_SLEEP_PASSWORD=your_password

2. 運行 MCP 客戶端一次以獲取您的用戶 ID：

node build/index.js getUsers

響應中將包含您的用戶 ID，請保存此值。 3. 將用戶 ID 添加到配置中。

環境變量

創建一個 .env 文件，並按以下格式填寫：

# Eight Sleep 身份驗證
EIGHT_SLEEP_EMAIL=your_email
EIGHT_SLEEP_PASSWORD=your_password
EIGHT_SLEEP_USER_ID=your_user_id  # 必填：使用上述任一方法獲取用戶 ID
EIGHT_SLEEP_CLIENT_ID=your_client_id
EIGHT_SLEEP_CLIENT_SECRET=your_client_secret

集成 Claude Desktop

將以下配置添加到 Claude Desktop 的配置（設置 → 開發者 → 編輯配置）中：

{
    "mcpServers": {
        "eight_sleep": {
            "command": "node",
            "args": ["/absolute/path/to/eight-sleep-mcp/build/index.js"],
            "env": {
                "EIGHT_SLEEP_EMAIL": "your_email", // 一旦擁有 userid，電子郵件和密碼不需要
                "EIGHT_SLEEP_PASSWORD": "your_password", // 一旦擁有 userid，電子郵件和密碼不需要
                "EIGHT_SLEEP_USER_ID": "your_user_id",
                "EIGHT_SLEEP_CLIENT_ID": "your_client_id", // 可選
                "EIGHT_SLEEP_CLIENT_SECRET": "your_client_secret" // 可選
            }
        }
    }
}

⚠️ 重要提示

將用戶 ID 添加到配置中是必需的，以避免每次請求時都需要通過電子郵件/密碼進行身份驗證。請確保使用上述任一方法獲取用戶 ID。保存配置後，重新啟動 Claude Desktop。

✨ 主要特性

用戶信息

• getUsers - 獲取用戶個人資料信息
• getUserPreferences - 獲取用戶偏好設置（單位，時區，床側）
• updateUserPreferences - 更新用戶偏好設置

設備控制

• getDeviceStatus - 獲取設備狀態（在線，固件版本，水位）
• setDevicePower - 關閉/開啟設備
• getPresence - 檢查用戶是否在床

溫度控制

• getTemperature - 獲取當前溫度設置
• setTemperature - 設置即時溫度（-100 到 100）
• getTemperatureSchedules - 獲取溫度計劃
• setTemperatureSchedule - 創建溫度計劃
• updateTemperatureSchedule - 更新溫度計劃
• deleteTemperatureSchedule - 刪除溫度計劃

睡眠數據

• getSleepData - 獲取日期範圍內的詳細睡眠數據
• getSleepScore - 獲取某一天的睡眠分數
• getSleepStages - 獲取睡眠階段（清醒，輕度，深度，REM）
• getHrv - 獲取心率變異性數據
• getHeartRate - 獲取心率數據
• getRespiratoryRate - 獲取呼吸速率數據
• getSleepPosition - 獲取睡眠姿勢

溫度計劃示例

setTemperatureSchedule({
  startTime: "22:00",
  level: -20,
  daysOfWeek: [0,1,2,3,4,5,6]  // 每天
})