Descripción general
MCP Server for Xiaozhi convierte Home Assistant en un servidor MCP al que se conecta un asistente de voz Xiaozhi AI: una placa ESP32 barata con micrófono y altavoz. El asistente entiende lo que dices con un modelo de lenguaje y usa las funciones de Home Assistant para encender, apagar o consultar.
Esquema: NODARA.
Requisitos
- Un dispositivo Xiaozhi AI configurado en su consola web, que te da la dirección de acceso MCP.
- Las entidades que quieras controlar, expuestas a Assist en Ajustes → Asistentes de voz → Exponer.
- HACS → «MCP Server for Xiaozhi» → Descargar, reinicia y añádela con la dirección de acceso; marca la API Assist.
- Repositorio: c1pher-cn/ha-mcp-for-xiaozhi. Su documentación está sobre todo en chino.
Ideas de uso
- Encender y apagar luces por voz desde un altavoz casero. Es el ejemplo de abajo.
- Preguntar la temperatura de cualquier habitación.
- Scripts como órdenes: expón un script «modo cine» y pídeselo por su nombre.
- Asistente en el cuarto de los niños con solo sus luces expuestas.
- Varios Xiaozhi por la casa, cada uno con su propia entrada en la integración.
- Otras API MCP que tengas en Home Assistant, compartidas con el asistente a la vez.
Ejemplo de uso
No hay YAML: se usa hablando con el dispositivo.
Acción
«Enciende la luz del salón»Resultado
light.salon = on
El Xiaozhi responde que la ha encendidoCómo funciona:
- Home Assistant se conecta directamente por WebSocket a los servidores de Xiaozhi, sin intermediarios.
- Las herramientas disponibles dependen de las entidades expuestas a Assist: si una luz no está expuesta, no puede controlarla.
- Las órdenes pasan por la nube de Xiaozhi. Expón solo lo que te parezca bien controlar así; evita cerraduras y alarmas.