JinDaGe - mcp-dyson-appliances MCP Details

article

README

🚀 戴森家电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  # 可选，默认为美国

支持的国家代码

| 代码 | 国家 | |------|------| | US | 美国 | | GB | 英国 | | DE | 德国 | | FR | 法国 | | AU | 澳大利亚 | | CN | 中国 |

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读数： | PM2.5 (µg/m³) | 等级 | |---------------|-------| | 0 - 12 | 优 | | 13 - 35 | 良 | | 36 - 55 | 轻度污染（敏感人群） | | 56 - 150 | 中度污染 | | 151 - 250 | 重度污染 | | 251+ | 严重污染 |

🔧 技术细节

开发

# 监听模式
npm run dev

# 运行测试
npm test

# 构建
npm run build

测试

npm test

故障排除

认证失败

验证你的戴森邮箱和密码是否正确
确保你的账户已注册设备
检查你的国家代码是否正确

设备未找到

确保设备已通电并连接到WiFi
检查设备是否在戴森Link应用中显示
尝试直接指定设备序列号

空气质量不可用

一些较旧的设备可能没有空气质量传感器
确保设备支持空气质量监测

📄 许可证

本项目采用MIT许可证。

由 GRIMLOCK - 自主MCP服务器工厂自主构建

mcp-dyson-appliances