MCP Dyson Appliances

🚀 mcp-dyson-appliances

Dysonの空気清浄機や扇風機を制御するためのMCP（Model Context Protocol）サーバーです。

✨ 主な機能

• 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

📚 ドキュメント

前提条件

• Node.js 18以上
• 登録済みデバイスを持つDysonアカウント
• ネットワークに接続されたDysonデバイス

対応デバイス

• Pure Cool Link (Tower & Desk)
• Pure Cool
• Pure Hot+Cool
• Pure Hot+Cool Link
• Pure Humidify+Cool
• Pure Cool Formaldehyde

環境変数の設定

export DYSON_EMAIL=your-email@example.com
export DYSON_PASSWORD=your-password
export DYSON_COUNTRY=US  # オプション、デフォルトはUS

対応する国コード

• US - アメリカ合衆国
• GB - イギリス
• DE - ドイツ
• FR - フランス
• AU - オーストラリア
• CN - 中国

Claude Desktopの設定

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"
      }
    }
  }
}

空気質指数（AQI）レベル

PM2.5の測定値に基づいています。

開発

# ウォッチモード
npm run dev

# テストの実行
npm test

# ビルド
npm run build

テスト

npm test

トラブルシューティング

認証に失敗しました

• Dysonのメールアドレスとパスワードが正しいことを確認してください。
• アカウントに登録済みのデバイスがあることを確認してください。
• 国コードが正しいことを確認してください。

デバイスが見つかりません

• デバイスが電源オンで、WiFiに接続されていることを確認してください。
• Dyson Linkアプリにデバイスが表示されることを確認してください。
• デバイスのシリアル番号を直接指定してみてください。

空気質情報が利用できません

• 一部の古いデバイスには空気質センサーが搭載されていない場合があります。
• デバイスが空気質監視をサポートしていることを確認してください。

セキュリティに関する注意事項

• 資格情報は環境変数を介して渡されます（ハードコードしないでください）。
• サーバーはすべてのAPI通信にHTTPSを使用しています。
• 本番環境ではシークレットマネージャーの使用を検討してください。

💻 使用例

デバイスの状態を取得する

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

📄 ライセンス

MIT

GRIMLOCK - Autonomous MCP Server Factoryによって自動構築されました