用途
wemo-mcp-server 用于让 AI 助手通过自然语言控制 WeMo 智能家居设备。它基于 Model Context Protocol（MCP）构建，并依赖 pywemo 与设备通信。该服务器完全在本地网络内运行，所有设备命令均通过本地网络传输，不经过 Belkin 云端。
主要能力
- 设备发现：多阶段智能扫描（UPnP/SSDP 多播发现、网络端口扫描、HTTP 设备验证），宣称 100% 发现可靠性。支持并行探测，扫描完整子网约需 23-30 秒。
- 设备控制：支持开启、关闭、切换、亮度调节（所有设备类型）。
- 设备管理：重命名设备、提取 HomeKit 设置代码。
- 状态查询：查询设备实时状态和亮度。
- 缓存：持久化设备缓存，TTL 为 1 小时，重启后依然有效；可查看和清除缓存。
- 配置：通过 YAML 配置文件和环境变量（前缀 WEMO_MCP_）进行设置，如网段、缓存等。
- 自动重试：网络错误时自动重试，采用指数退避。
- 错误处理：提供详细错误信息和可操作建议。
- MCP 原语：支持 MCP 资源（devices:// 和 device://{id} URI 订阅实时设备数据）、MCP 提示（discover、status report、scene control、troubleshoot 四个内置引导提示）、MCP 交互澄清（当子网或设备名称不明确时主动询问）。
使用方式
- 安装 uv（uv Python 包管理器），然后重启终端并验证。
- 配置 MCP 客户端：支持 Claude Code CLI、Claude Desktop、VS Code、Cursor、Cline、Windsurf、Zed、Continue 等。可以一键安装或手动编辑配置文件。例如 Claude Desktop 编辑
~/Library/Application Support/Claude/claude_desktop_config.json，VS Code 编辑~/.vscode/mcp.json，Cursor 编辑~/.cursor/mcp.json等。保存后重启对应客户端。 - 配置网段：默认子网为
192.168.1.0/24，若设备在其他子网（如192.168.86.0/24），需在 MCP 客户端配置中通过env设置，或导出环境变量，或使用 YAML 配置文件。 - 使用工具：通过自然语言指令调用工具，例如“扫描网络上的 WeMo 设备”、“打开办公室的灯”、“将卧室灯调暗到 50%”、“获取办公室灯的 HomeKit 代码”等。
- 开发版本：如需使用开发版本，可在 MCP 客户端配置中指定。
适用场景
- 希望通过 AI 助手（如 Claude、VS Code Copilot 等）以语音或文字自然语言控制家中 WeMo 设备的用户。
- 需要本地控制、不希望依赖云端的智能家居用户。
- 需要批量发现、管理多个 WeMo 设备（包括调光器、开关等）的场景。
- 需要将 WeMo 设备集成到支持 MCP 的 AI 工作流中的开发者。
限制
- 不是所有 WeMo 设备都支持 HomeKit；不支持时获取 HomeKit 代码会返回错误。
- 部分功能（如定时调度、WiFi 配网、维护工具）未在 MCP 中实现，因为需要后台常驻守护进程或会中断主机网络。
- 需自行安装 uv，并配置正确的网段才能发现设备。
- 服务器通过 uvx 运行，需要 MCP 客户端支持。
- 收费、价格、具体商业化信息暂未提供。
