eWeLink 文档eWeLink MCP Server 使用教程：用 AI 控制你的智能家居
一步步教你设置 eWeLink MCP Server，连接 Cursor 等 AI 客户端，用自然语言轻松控制智能家居设备。
通过 eWeLink MCP Server（V5.22，Prime），你可以将支持 MCP 协议的 AI 客户端和智能体连接到你的 eWeLink 账户，用简单的自然语言指令控制支持的智能设备。它基于 Model Context Protocol (MCP) 构建，在先进的 AI 助手和你的 IoT 设备之间架起桥梁——让你能通过对话的方式查询设备状态、检查开关情况并触发各种操作。
本教程将带你完成全部设置流程：在 App 中启用 MCP Server、生成 MCP URL、在 Cursor 中配置连接，以及运行几条简单的提示词来验证一切正常。
设置步骤详解
第一步：在 eWeLink App 中启用 MCP Server
- 打开 eWeLink App。
- 依次进入：我的 → 试验功能 → MCP Server
第二步：生成 MCP Server URL（并管理访问权限）
进入 MCP Server 页面后，你会看到以下访问管理选项：
- 复制 URL — 复制你的 MCP Server URL，粘贴到 AI 客户端的 MCP 配置中。
- 刷新 Token — 当前 URL 过期时，可以生成新的 URL。
- 撤销授权 — 立即阻断 AI 访问。当你需要出于隐私或安全考虑切断所有已连接的 AI 客户端时使用。
最佳实践： 如果你怀疑 URL 被泄露或分享给了他人，请立即使用"撤销授权"，然后重新生成一个新的 URL。
第三步：配置 AI 客户端（以 Cursor 为例）
获取 Cursor： 下载 Cursor 并注册或登录你的账户。
进入设置： 打开 Cursor，前往 Settings → Tools & MCP → Add Custom MCP
添加服务器： 使用以下 JSON 格式创建新条目：
{
"mcpServers": {
"ewelink": {
"type": "http",
"url": "PASTE_YOUR_eWeLink_MCP_SERVER_URL_HERE"
}
}
}
保存并重启： 保存配置后，打开一个新的聊天或智能体会话。
建议： 在工具栏中开启 Auto 选项。不同的智能体模式对 MCP 的支持程度不同，Auto 模式能帮你自动选择最合适的模式。
测试你的设置
配置完成后，试试用以下对话与 AI 助手互动：
- "我有多少个设备？"
- "哪些设备现在是开着的？"
- "把客厅的开关打开。"
兼容性说明与当前限制
这是初始版本，存在一些限制：
- 仅支持的设备会出现在设备查询结果中。
- 如果某个设备尚未被支持，AI 客户端将无法通过 MCP 列出或控制它。
- 不同的 AI 智能体模式可能表现不同。
- 相同的提示词在不同模式下可能成功或失败。如果遇到问题，请尝试 Auto 模式或切换其他模式。
当前支持的设备
初始版本主要支持开关和插座类设备，包括以下热门型号：
| 设备类型 | 适用设备型号（示例） |
|---|---|
| 单通道插座 | SONOFF BASIC_R3, SONOFF MINI, SONOFF RF_R2, SONOFF S20R1, SONOFF S26, SONOFF S31 Lite, SONOFF S55R1, SONOFF S30 |
| 单通道插座（支持 2.4G eWeLink-Remote） | SONOFF BASICR4, SONOFF MINI-D, SONOFF MINIR3, SONOFF MINIR4, SONOFF S40 lite |
| DIY 智能开关 | SONOFF Basic, SONOFF RF, SONOFF SV |
| 单通道开关 | SONOFF RF R2, SONOFF T1 1C, SONOFF Touch, SONOFF TX1C |
| 双通道开关 | SONOFF T1 2C, SONOFF TX2C |
| 三通道开关 | SONOFF T1 3C, SONOFF TX3C |
| 四通道插座 | SONOFF 4CH |
| 功率检测插座 | SONOFF IW100_US, SONOFF IW101_US, SONOFF Pow R2, SONOFF POWR3, SONOFF S31 |
| 双通道插座 | SONOFF DUALR2 |
| 温湿度监测智能开关 | SONOFF S22_CN, SONOFF TH10, SONOFF TH16 |
| 功率监测插座（过载报警） | SONOFF S40, SONOFF S40TPA, SONOFF S40TPB |
| 带 LCD 屏幕的 POWR3 | SONOFF POWCT, SONOFF POWR316, SONOFF POWR320D, SONOFF S60TPF, SONOFF S60TPG |
| 温湿度监测开关（含历史记录） | SONOFF TH16R3, SONOFF THR316, SONOFF THR320 |
| 单通道插座（多通道版本） | SONOFF Micro |
| 四通道插座（支持 2.4G eWeLink-Remote） | BL1-S04-01, CK-BL602-4SW-HS |
故障排除与技巧
- URL 无法使用？ 尝试在 eWeLink App 中重新生成 Token。
- 找不到设备？ 检查你的设备型号是否在上方支持列表中。
- 命令无法执行？ 确保你使用的是兼容的 AI 模式（建议使用"Auto"）。
- 安全顾虑？ 立即使用"撤销授权"，然后重新生成新的 URL。
一切就绪。在 eWeLink App 中启用 MCP Server，连接到你的 AI 客户端，然后用简单的自然语言指令开始控制你的智能设备吧。
关注 eWeLink 动态
想了解 eWeLink 的最新动态和智能家居使用技巧，欢迎通过以下渠道关注我们：
- 论坛：eWeLink Forum
- Facebook：ewelink.support
- X：eWeLinkapp
- YouTube：eWeLink Smart Home
- 官网：ewelink.cc