Asistente de hogar MCP

Se trata de un servidor MCP (Protocolo de contexto de modelo) que proporciona herramientas para la integración con Home Assistant, permitiendo que los asistentes de IA interactúen con dispositivos domésticos inteligentes.

Configuración

Instalación mediante herrería

Para instalar Home Assistant Integration para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @guilhermelirio/homeassistant-mpc --client claude

Instalación manual

1. Instalar dependencias:

npm install

2. Configurar variables de entorno:

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

   • Configure las variables de entorno en un archivo .env en la raíz del proyecto:

HOME_ASSISTANT_URL=http://your-home-assistant:8123
HOME_ASSISTANT_TOKEN=your_token_here

Related MCP server: Enhanced Home Assistant MCP

Iniciando el servidor

npm start

Para desarrollo:

npm run dev

Herramientas disponibles

Verificación de la API de Home Assistant

• homeassistant_api : verifica si la API de Home Assistant está en línea

  • Parámetros: ninguno

  • Ejemplo: homeassistant_api()

Obtener el estado de la entidad

• homeassistant_get_state : Obtiene el estado actual de una entidad de Home Assistant

  • Parámetros: entity_id (ID de la entidad)

  • Ejemplo: homeassistant_get_state("light.living_room")

Servicios de llamadas

• homeassistant_call_service : llama a un servicio para una entidad de Home Assistant

  • Parámetros:

    • entity_id (ID de entidad)

    • domain (dominio de servicio)

    • service (servicio a llamar)

  • Ejemplo: homeassistant_call_service("light.living_room", "light", "turn_on")

Desarrollo

Este proyecto utiliza TypeScript y la biblioteca MCP SDK para crear herramientas a las que pueden acceder modelos de lenguaje como Claude, GPT, etc.

Para agregar nuevas herramientas:

1. Crear un módulo en src/tools/[category]

2. Implementa tus herramientas siguiendo el patrón existente

3. Registra el módulo en src/index.ts

Contribuciones

¡Agradecemos sus contribuciones! No dude en abrir problemas o enviar solicitudes de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.