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:

Buscar entidades en su instancia de Home Assistant
Dispositivos de control (encenderlos/apagarlos)
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

Clonar este repositorio
Configurar un entorno de Python:

cd home-assistant
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -U pip
pip install uv
uv pip install -e .

Configuración

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

Vaya a su instancia de Home Assistant
Navega a tu perfil (haz clic en tu nombre de usuario en la barra lateral)
Desplácese hacia abajo hasta "Tokens de acceso de larga duración".
Cree un nuevo token con un nombre descriptivo como "Integración MCP".
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:

{
  "mcpServers": {
    "home_assistant": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/home-assistant-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "HOME_ASSISTANT_TOKEN": "your_home_assistant_token_here"
      },
      "inheritEnv": true
    }
  }
}

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:

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
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:

Búsqueda de entidades mediante lenguaje natural
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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Una integración del Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA controlar los dispositivos Home Assistant buscando entidades y controlando dispositivos a través de comandos de lenguaje natural.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Personal Assistant Agent
zhangzhongnan928
-
security
F
license
-
quality
A versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.
Last updated -
2
Python
argocd-mcp
severity1
A
security
A
license
A
quality
An MCP (Model Context Protocol) server that integrates with the ArgoCD API, enabling AI assistants and large language models to manage ArgoCD applications and resources through natural language interactions.
Last updated -
10
6
Python
MIT License
Hass-MCP
voska
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to interact directly with Home Assistant, allowing them to query device states, control smart home entities, and perform automation tasks.
Last updated -
104
Python
MIT License
DroidMind
hyperb1iss
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that enables AI assistants to control and interact with Android devices, allowing for device management, app debugging, system analysis, and UI automation through natural language commands.
Last updated -
29
143
Python
Apache 2.0

View all related MCP servers

Home Assistant MCP