MCP Dyson Appliances

🚀 戴森家電MCP服務器

這是一個用於控制戴森空氣淨化器和風扇的MCP（模型上下文協議）服務器，可幫助用戶方便地管理戴森設備的各項功能。

🚀 快速開始

本項目提供了對戴森空氣淨化器和風扇的控制功能，藉助MCP協議，你能遠程獲取設備狀態、調整風扇速度、控制擺動等操作。

✨ 主要特性

• get_device_status - 獲取當前設備狀態（電源、風扇速度、擺動、夜間模式、空氣質量）
• set_fan_speed - 設置風扇速度（1 - 10或自動）
• set_oscillation - 開啟/關閉擺動功能
• get_air_quality - 獲取詳細的空氣質量讀數（PM2.5、PM10、VOC、NO2、溼度、溫度）
• set_night_mode - 開啟/關閉夜間模式

📦 安裝指南

從npm安裝（推薦）

npx mcp-dyson-appliances

從源碼安裝

git clone https://github.com/m2ai-mcp-servers/mcp-dyson-appliances.git
cd mcp-dyson-appliances
npm install
npm run build

📚 詳細文檔

配置

環境變量

export DYSON_EMAIL=your-email@example.com
export DYSON_PASSWORD=your-password
export DYSON_COUNTRY=US  # 可選，默認為美國

支持的國家代碼

Claude桌面配置

在 claude_desktop_config.json 中添加以下內容：

{
  "mcpServers": {
    "dyson": {
      "command": "npx",
      "args": ["-y", "mcp-dyson-appliances"],
      "env": {
        "DYSON_EMAIL": "your-email@example.com",
        "DYSON_PASSWORD": "your-password",
        "DYSON_COUNTRY": "US"
      }
    }
  }
}

支持的設備

• 純冷鏈（塔式和臺式）
• 純冷
• 純熱+冷
• 純熱+冷鏈
• 純加溼+冷
• 純冷甲醛

💻 使用示例

基礎用法

獲取設備狀態

get_device_status

返回結果：

{
  "device": {
    "serial": "ABC-XX-XXXXXXXX",
    "name": "Living Room"
  },
  "state": {
    "power": "on",
    "fanSpeed": "5",
    "oscillation": "on",
    "nightMode": "off",
    "autoMode": "off"
  },
  "airQuality": {
    "pm25": 8,
    "pm10": 12,
    "voc": 2,
    "no2": 1,
    "humidity": "45%",
    "temperature": "22.5°C",
    "level": "Good"
  }
}

設置風扇速度

set_fan_speed speed="5"
set_fan_speed speed="auto"
set_fan_speed device_id="ABC-XX-XXXXXXXX" speed="10"

設置擺動功能

set_oscillation enabled=true
set_oscillation device_id="ABC-XX-XXXXXXXX" enabled=false

獲取空氣質量

get_air_quality

返回結果：

{
  "pm25": {
    "value": 8,
    "unit": "µg/m³",
    "level": "Good"
  },
  "pm10": {
    "value": 12,
    "unit": "µg/m³"
  },
  "voc": {
    "value": 2,
    "unit": "index",
    "description": "Low"
  },
  "no2": {
    "value": 1,
    "unit": "index",
    "description": "Low"
  },
  "humidity": {
    "value": 45,
    "unit": "%",
    "description": "Comfortable"
  },
  "temperature": {
    "celsius": 22.5,
    "fahrenheit": 73
  }
}

設置夜間模式

set_night_mode enabled=true
set_night_mode device_id="ABC-XX-XXXXXXXX" enabled=false

空氣質量指數（AQI）等級

基於PM2.5讀數：

🔧 技術細節

開發

# 監聽模式
npm run dev

# 運行測試
npm test

# 構建
npm run build

測試

npm test

故障排除

認證失敗

• 驗證你的戴森郵箱和密碼是否正確
• 確保你的賬戶已註冊設備
• 檢查你的國家代碼是否正確

設備未找到

• 確保設備已通電並連接到WiFi
• 檢查設備是否在戴森Link應用中顯示
• 嘗試直接指定設備序列號

空氣質量不可用

• 一些較舊的設備可能沒有空氣質量傳感器
• 確保設備支持空氣質量監測

📄 許可證

本項目採用MIT許可證。

由 GRIMLOCK - 自主MCP服務器工廠自主構建