Plugwise MCP 是一个基于 TypeScript 的 Model Context Protocol（MCP）服务器，用于将 Plugwise 智能家居系统集成到支持 MCP 的 AI 客户端中。它提供自动网络发现、设备控制、温度管理、能源监测和多网关管理能力。
用途 该服务器旨在让 AI 客户端（如 Cline、Cursor、VS Code Copilot、Windsurf 等）通过标准输入输出（stdio）与 Plugwise 网关通信，从而以自然语言或程序化方式控制智能家居设备。
主要能力
- AI 智能体模式：通过内置 AI 智能体实现自然语言控制。
- JSON-RPC 支持：提供程序化 API，便于脚本和自动化。
- 自动网络扫描：发现网络中所有 Plugwise 网关。
- 凭证管理：从 .env 文件安全存储网关密码。
- 设备控制：控制恒温器、开关和智能插座。
- 温度管理：设置温度、预设和日程。
- 能源监测：读取功耗和传感器数据。
- 多网关支持：同时管理多个网关。
- 实时更新：获取当前设备状态和测量值。
使用方式 安装：
- 通过 npm 全局安装（推荐）：npm install -g plugwise-mcp
- 或直接使用 npx（无需安装）：npx plugwise-mcp
- 从源码安装：需要 Node.js 17 或更高版本，以及 Plugwise 网关（Adam、Anna、Smile P1 或 Stretch）。
启动服务器：
- 标准 MCP 服务器模式（15+ 专用工具）：安装后运行 plugwise-mcp；从源码运行则使用相应命令。
- AI 智能体模式（单一自然语言工具）：使用 manage_plugwise 工具。
添加到 MCP 客户端： 服务器可与任何支持 stdio 传输的 MCP 客户端配合。配置方式因客户端而异：
- Cline：编辑 cline_mcp_settings.json。
- Cursor：编辑 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）。
- VS Code Copilot：编辑 .vscode/mcp.json（项目级）或用户设置（全局）。
- Windsurf：编辑 ~/.codeium/windsurf/mcp_config.json。
环境变量： 服务器从环境变量读取网关密码，可通过 MCP 配置的 env 字段或 .env 文件提供。安全提示：使用 MCP 配置 env 字段时凭证会安全传递给服务器进程；建议使用 .env 文件（通常被版本控制排除）。
主要工具与功能：
- 网络发现：连接 Plugwise 网关。
- 设备管理：获取所有设备及其当前状态。
- 气候控制：设置恒温器温度设定点、更改预设模式、打开/关闭开关/插座。
- 网关管理：set_gateway_mode（家庭、离开、度假）、set_dhw_mode（生活热水模式：自动、增压、舒适、关闭）、set_regulation_mode（供暖调节模式）、delete_notification（清除网关通知）、reboot_gateway（重启网关，谨慎使用）。
- 资源：plugwise://devices 可访问所有设备当前状态。
- 提示：setup_guide 提供全面的分步设置说明。
测试： 提供全面的只读测试套件，包括服务器健康检查、MCP 协议初始化、网络扫描、网关连接和信息检索、设备状态读取、资源和提示。测试仅执行读取操作，不改变设备状态。
支持的设备：
- 网关：Adam（支持 OpenTherm 的智能家居中枢，恒温器控制、地暖）、Anna（独立恒温器网关）、Smile P1（能源监测网关：电力、燃气、太阳能）、Stretch（用于连接 Circle 智能插座的旧版中枢）。
- 连接设备：Jip（带照度检测的运动传感器）、Lisa（散热器阀门，需中枢）、Tom/Floor（地暖控制器）、Koen（散热器阀门，需通过 Plug 中转）、Plug（带功率监测的智能插座，Zigbee）、Aqara Plug（第三方 Zigbee 智能插座）、Circle（旧版 Circle/Circle+ 插座，仅通过 Stretch）。
适用场景 适用于希望将 Plugwise 智能家居系统接入 AI 助手或自动化脚本的用户，实现自然语言控制、能源监测、多网关管理等功能。
限制
- 需要 Node.js 17 或更高版本。
- 需要 Plugwise 网关硬件。
- 网络安全性：Plugwise 使用 HTTP Basic Auth（非 HTTPS），建议将网关置于安全本地网络，远程访问使用 VPN，考虑为 IoT 设备使用独立 VLAN。
- API 对供暖系统有完全控制权，需限制访问。
- 项目基于 python-plugwise 库，架构模式受 sonos-ts-mcp 启发。
- 当前版本 1.0.2，采用 MIT 许可证。
文档： 提供设置指南、MCP 服务器文档、网络扫描指南、测试文档等。
