loxone-mcp

一个将 AI 助手连接到 Loxone Miniserver 智能家居系统的 MCP（模型上下文协议）服务器。

允许 Claude（或任何兼容 MCP 的 AI）列出房间、查询实时传感器/执行器状态、搜索设备并发送命令。

功能

• list_rooms — 所有房间及其控件

• list_controls — 所有控件（名称、类型、UUID、房间）

• find_control — 跨名称/房间/类型的关键字搜索

• get_status — 实时传感器和执行器值（可选房间过滤器）

• control_device — 发送命令（开/关、调光百分比、百叶窗、暖通空调、音频）

Related MCP server: Loxone MCP Server

要求

• 已启用 Cloud Connect 的 Loxone Miniserver

• Node.js 20+（或 Docker）

安装

npm

npm install -g @syntropic/loxone-mcp

然后设置环境变量并运行：

LOXONE_SERIAL=XXXXXXXXXXXX \
LOXONE_USER=admin \
LOXONE_PASS=yourpass \
MCP_API_KEY=$(openssl rand -hex 32) \
loxone-mcp

从源码安装

git clone https://github.com/syntropicsignal-ai/loxone-mcp.git
cd loxone-mcp
cp .env.example .env
# edit .env with your Miniserver serial, credentials, and a random API key
npm install
npm run build
npm start

服务器监听 http://localhost:3000。MCP 端点为 POST /mcp。

Docker

docker build -t loxone-mcp .
docker run -p 3000:3000 --env-file .env loxone-mcp

配置

连接到 Claude

添加到您的 Claude MCP 配置中：

{
  "mcpServers": {
    "loxone": {
      "url": "https://your-server/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

按设备类型支持的命令

架构

• 无状态 HTTP 服务器 — 每个 POST /mcp 都会创建一个新的传输（无会话状态）

• Loxone Cloud Connect：在每次请求时通过 dns.loxonecloud.com 解析当前的隧道 URL

• 结构缓存：Loxone 应用结构 (LoxAPP3.json) 缓存 60 秒

许可证

MIT