用途
matter-controller-mcp 是一个面向 Matter Controller 的 MCP（Model Context Protocol）服务器，用于让 AI 助手与 AI 应用发现、配网并控制 Matter 兼容的智能家居设备。它作为 MCP 客户端与 Matter 设备之间的桥梁，提供设备控制与监控的标准化接口。
主要能力
- 设备管理：对 Matter 设备进行配网（commission）与取消配网（decommission），并支持自动连接；可获取控制器状态、列出已配网设备、获取设备详细信息。
- 设备控制：控制灯光、开关等设备；支持开关/切换、亮度/调光（0-254）、颜色温度与色相/饱和度控制。
- 设备信息：获取详细的设备信息与能力结构。
- 属性访问：直接读取与写入设备集群（cluster）属性，支持读取特定属性或全部属性，写入支持批量操作。
- 传输方式：支持 stdio、SSE 和可流式 HTTP（streamable HTTP）三种传输方式。
- 配置：支持基于环境变量的配置选项。
支持的设备类型
- 照明：开/关灯、可调光灯、彩色灯
- 开关：智能开关与插座
- 传感器：各类传感器（温度、湿度等）
- 以及更多：任何 Matter 兼容设备
使用方式
该服务器可作为 MCP 服务器使用（默认 stdio 传输），也支持可流式 HTTP 传输，并提供 Cursor MCP 服务器的集成方式。仓库中说明支持通过环境变量进行配置；文档给出了配网设备、读取设备信息等操作示例，以及可用工具列表（如 get_controller_status、commission_device、get_commissioned_devices、decommission_device、get_device_info、control_onoff_device、control_level_device、control_color_device、read_attributes、write_attributes）。
环境与依赖
- TypeScript 5.6+
- 兼容 Matter.js 的系统
- BLE 支持（可选，用于 BLE 配网） 开发约定包括：在导入路径中使用带 .js 扩展名的 ES 模块、使用 TypeScript 严格类型、遵循 zod schema 模式进行工具输入校验、优先使用 async/await、使用描述性变量名与适当错误处理。
适用场景
适合需要让 AI 智能体通过统一 MCP 协议操控 Matter 智能家居设备的场景，例如家庭自动化、设备集中管理与调试、通过 AI 助手进行灯光与开关控制等。
限制与注意事项
资料未提供具体收费、价格与平台限制信息。故障排查提示包括：设备未找到（确认设备处于配对模式且在同一网络）、连接超时、权限错误（BLE 访问权限）、端口冲突（HTTP/SSE 传输时可修改 PORT 环境变量）、控制器初始化失败、设备配网失败等。项目采用 MIT 许可证。
