Servidor MCP de Home Assistant

¿Qué hace el servidor MCP de “Home Assistant”?

El Servidor MCP de Home Assistant (hass-mcp) es un servidor del Protocolo de Contexto de Modelo (MCP) que conecta asistentes de IA—como Claude y otros LLMs—con tu ecosistema de Home Assistant. Al exponer los datos y funcionalidades de Home Assistant mediante el estándar MCP, permite que los agentes de IA interactúen, consulten y controlen dispositivos y automatizaciones inteligentes. Las tareas habituales habilitadas por hass-mcp incluyen consultar estados de dispositivos y sensores, alternar luces o interruptores, resumir el estado del hogar, solucionar problemas de automatizaciones, buscar entidades específicas y facilitar conversaciones guiadas para actividades comunes del hogar inteligente. Esta integración mejora los flujos de trabajo de desarrolladores y usuarios al hacer que la gestión del hogar inteligente sea accesible mediante IA conversacional, automatizaciones y agentes potenciados por LLM.

Lista de Prompts

• No se encontraron plantillas de prompts documentadas en el repositorio.

Lista de Recursos

• No se listaron recursos MCP explícitos en el repositorio.

Lista de Herramientas

• Consultar el estado de dispositivos y sensores: Permite que los LLM recuperen el estado actual de las entidades de Home Assistant.
• Controlar luces, interruptores y otras entidades: Habilita el control directo (encendido/apagado, brillo, etc.) de componentes inteligentes compatibles.
• Obtener resúmenes de tu hogar inteligente: Proporciona resúmenes generales o información agregada sobre el estado actual del hogar.
• Solucionar problemas de automatizaciones y entidades: Ofrece información de diagnóstico o pasos para resolver problemas con automatizaciones o entidades de dispositivos.
• Buscar entidades específicas: Permite que usuarios o agentes localicen dispositivos o sensores por nombre o tipo dentro de Home Assistant.
• Crear conversaciones guiadas para tareas comunes: Soporta interacciones estructuradas para guiar a los usuarios en operaciones frecuentes del hogar inteligente.

Casos de Uso de este Servidor MCP

• Consulta de estado de dispositivos: Desarrolladores y usuarios pueden solicitar de manera programática o conversacional los estados actuales (ej. “¿Está abierta la ventana de la cocina?”), lo que ayuda en la monitorización y lógica de automatización.
• Control del Hogar Inteligente: Permite que asistentes de voz o chatbots enciendan/apaguen luces, ajusten termostatos o controlen electrodomésticos, mejorando la accesibilidad y la automatización.
• Informes de Resumen del Hogar: Los LLM pueden generar resúmenes diarios o bajo demanda (ej. “¿Cuál es el estado de mi hogar esta noche?”) para mayor comodidad del usuario o integración en paneles.
• Solución de Problemas de Automatizaciones: Los desarrolladores pueden aprovechar el servidor MCP para identificar fallos o errores de configuración en automatizaciones, agilizando la depuración.
• Búsqueda de Entidades y Flujos de Tareas Guiadas: Localizar rápidamente dispositivos o guiar a los usuarios en rutinas complejas de varios pasos (ej. “Configura una rutina matutina”) simplifica la gestión del hogar inteligente.

Cómo configurarlo

Windsurf

1. Asegúrate de tener Python y Docker instalados en tu sistema.
2. Clona el repositorio de hass-mcp y configura tu conexión de Home Assistant en un archivo .env (ver .env.example).
3. En Windsurf, abre la sección de Servidores MCP en tus ajustes.
4. Añade el servidor hass-mcp usando una configuración JSON como:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "docker",
         "args": ["run", "--env-file=.env", "-p", "8080:8080", "voska/hass-mcp:latest"]
       }
     }
   }
   

5. Guarda los ajustes y reinicia Windsurf. Verifica que el servidor aparezca en la lista MCP.

Claude

1. Despliega el servidor hass-mcp localmente o en un servidor accesible para Claude.
2. Protege tu clave API de Home Assistant usando variables de entorno.
3. En la configuración de Claude, añade la entrada del servidor MCP:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. Reinicia Claude y comprueba la disponibilidad del servidor MCP.
5. Usa variables de entorno para proteger datos sensibles (ver más abajo).

Cursor

1. Despliega hass-mcp y asegúrate de que haya acceso de red entre Cursor y el servidor MCP.
2. Configura Cursor para usar el servidor MCP:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

3. Guarda la configuración y reinicia Cursor.
4. Establece variables de entorno para las claves API según sea necesario.

Cline

1. Instala las dependencias y ejecuta el servidor hass-mcp (ver detalles en el repositorio).
2. En Cline, abre tu archivo de configuración MCP.
3. Añade el servidor hass-mcp:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. Reinicia Cline para habilitar el nuevo servidor MCP.

Protegiendo Claves API (Todas las Plataformas):

Utiliza variables de entorno en tu configuración para proteger información sensible:

{
  "mcpServers": {
    "hass-mcp": {
      "env": {
        "HASS_TOKEN": "${HASS_TOKEN}"
      },
      "inputs": {
        "hass_url": "http://your-homeassistant.local:8123"
      }
    }
  }
}

Cómo usar este MCP dentro de los flujos

Uso de MCP en FlowHunt

Para integrar servidores MCP en tu flujo de trabajo de FlowHunt, comienza añadiendo el componente MCP a tu flujo y conectándolo a tu agente de IA:

Haz clic en el componente MCP para abrir el panel de configuración. En la sección de configuración MCP del sistema, inserta los detalles de tu servidor MCP usando este formato JSON:

{
  "hass-mcp": {
    "transport": "streamable_http",
    "url": "https://tuservidormcp.ejemplo/rutamcp/url"
  }
}

Una vez configurado, el agente de IA podrá usar este MCP como herramienta con acceso a todas sus funciones y capacidades. Recuerda cambiar “hass-mcp” por el nombre real de tu servidor MCP y reemplazar la URL por la de tu propio servidor MCP.

Resumen

Según la documentación disponible y el contenido del repositorio, hass-mcp proporciona una base sólida para la integración de Home Assistant mediante MCP, con un soporte claro de herramientas y buenas prácticas de configuración/seguridad. Sin embargo, hay una falta de plantillas de prompt explícitas, definiciones de recursos o características avanzadas de muestreo/roots en la documentación pública. Calificaría este servidor MCP con un 6/10: funcional y amigable para desarrolladores, pero con carencia de documentación de extensibilidad y funciones avanzadas de MCP.

Puntuación MCP