loxone-mcp

Un servidor MCP (Model Context Protocol) que conecta asistentes de IA a un sistema de hogar inteligente Loxone Miniserver.

Permite a Claude (o cualquier IA compatible con MCP) listar habitaciones, consultar estados de sensores/actuadores en tiempo real, buscar dispositivos y enviar comandos.

Características

• list_rooms — todas las habitaciones con sus controles

• list_controls — todos los controles (nombre, tipo, UUID, habitación)

• find_control — búsqueda por palabras clave en nombre/habitación/tipo

• get_status — valores de sensores y actuadores en tiempo real (filtro de habitación opcional)

• control_device — enviar comandos (Encendido/Apagado, % de atenuación, persianas, climatización, audio)

Related MCP server: Loxone MCP Server

Requisitos

• Loxone Miniserver con Cloud Connect habilitado

• Node.js 20+ (o Docker)

Instalación

npm

npm install -g @syntropic/loxone-mcp

Luego ejecute con las variables de entorno configuradas:

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

Desde el código fuente

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

El servidor escucha en http://localhost:3000. El punto final MCP es POST /mcp.

Docker

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

Configuración

Conexión a Claude

Añada a su configuración de Claude MCP:

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

Comandos admitidos por tipo de dispositivo

Arquitectura

• Servidor HTTP sin estado: cada POST /mcp crea un transporte nuevo (sin estado de sesión)

• Loxone Cloud Connect: resuelve la URL del túnel actual a través de dns.loxonecloud.com en cada solicitud

• Caché de estructura: estructura de la aplicación Loxone (LoxAPP3.json) almacenada en caché durante 60 segundos

Licencia

MIT