Asistente de hogar MCP

Una integración del Protocolo de Contexto de Modelo (MCP) para controlar dispositivos Home Assistant mediante asistentes de IA.

Descripción general

Este MCP permite que los asistentes de IA controlen tus dispositivos Home Assistant. Proporciona herramientas para:

1. Buscar entidades en su instancia de Home Assistant
2. Dispositivos de control (encenderlos/apagarlos)
3. Controlar los colores y el brillo de la luz

Prerrequisitos

• Python 3.11 o superior
• Instancia de Home Assistant en ejecución y accesible a través de API
• Token de acceso de larga duración de Home Assistant

Instalación

1. Clonar este repositorio
2. Configurar un entorno de Python:

Configuración

Obtenga un token de acceso de larga duración de Home Assistant

1. Vaya a su instancia de Home Assistant
2. Navega a tu perfil (haz clic en tu nombre de usuario en la barra lateral)
3. Desplácese hacia abajo hasta "Tokens de acceso de larga duración".
4. Cree un nuevo token con un nombre descriptivo como "Integración MCP".
5. Copia el token (solo lo verás una vez)

Configurar en Cursor AI

Agregue la siguiente configuración a su configuración de MCP en Cursor:

Reemplazar:

• /path/to/your/home-assistant con la ruta real a este directorio
• your_home_assistant_token_here con su token de acceso de larga duración de Home Assistant

Configuración de URL de Home Assistant

De forma predeterminada, el MCP intenta conectarse a Home Assistant en http://homeassistant.local:8123 .

Si su Home Assistant está en una URL diferente, puede modificar la variable HA_URL en app/config.py .

Uso

Una vez configurado, puedes usar Cursor AI para controlar tus dispositivos Home Assistant:

• Buscar dispositivos: "Buscar las luces de mi salón"
• Dispositivos de control: "Enciende la luz de la cocina"
• Controlar los colores de la luz: "Pon las luces de mi sala en rojo"
• Ajustar el brillo: "Configurar las luces de mi comedor en azul con un brillo del 50 %"

Funciones de control de luz

El MCP ahora admite capacidades avanzadas de control de iluminación:

1. Control de color : configure cualquier color RGB para luces compatibles
   • Especifique colores utilizando valores RGB (0-255 para cada componente)
   • Ejemplo: set_device_color("light.living_room", 255, 0, 0) para rojo
2. Control de brillo : ajusta el brillo de la luz
   • Parámetro de brillo opcional (0-255)
   • Se puede combinar con cambios de color.
   • Ejemplo: set_device_color("light.dining_room", 0, 0, 255, brightness=128) para azul medio brillante

Solución de problemas

• Si recibe errores de autenticación, verifique que su token sea correcto y no haya expirado
• Verifique que su instancia de Home Assistant sea accesible en la URL configurada
• Para problemas de control de color:
  • Verifique que su entidad de luz admita el control de color RGB
  • Compruebe que la luz esté encendida antes de intentar cambiar de color.

Capacidades futuras

Exposición de entidades dinámicas

La implementación actual requiere un proceso de dos pasos para controlar los dispositivos:

1. Búsqueda de entidades mediante lenguaje natural
2. Controlar la entidad utilizando su entity_id específico

Una mejora planificada es crear una forma más dinámica de exponer entidades a la herramienta de dispositivos de control, permitiendo que la IA:

• Controlar directamente los dispositivos a través de comandos más naturales (por ejemplo, "apagar las luces de la cocina")
• Almacene en caché las entidades utilizadas frecuentemente para un acceso más rápido
• Admite operaciones más complejas, como ajustar el brillo, la temperatura u otros atributos.
• Manejar grupos de entidades y escenas de forma más intuitiva

Esto reduciría significativamente el tiempo de acción y crearía una experiencia de usuario más fluida al controlar dispositivos Home Assistant a través de un asistente de IA.