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 :
Instalación manual
- Instalar dependencias:
- 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:
Iniciando el servidor
Para desarrollo:
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")
- Parámetros:
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")
- Parámetros:
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:
- Crear un módulo en
src/tools/[category]
- Implementa tus herramientas siguiendo el patrón existente
- 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.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Proporciona herramientas para que los asistentes de IA interactúen con dispositivos domésticos inteligentes a través de Home Assistant, lo que permite operaciones como verificar estados de entidades y llamar a servicios.
Related MCP Servers
- -securityAlicense-qualityAccess Home Assistant data and control devices (lights, switches, thermostats, etc).Last updated -6387TypeScriptApache 2.0
- -securityFlicense-qualityEnables users to control Google Home smart plugs using the Smart Home API with OAuth2 authentication, offering real-time device state management and control operations.Last updated -1TypeScript
- AsecurityAlicenseAqualityEnables AI assistants to control SwitchBot devices, providing functionalities like device management, scene execution, and sensor information monitoring through the SwitchBot API.Last updated -33JavaScriptISC License
- AsecurityAlicenseAqualityA server that enables interaction with Home Assistant devices and automations through the Model Context Protocol, allowing users to monitor device states, control devices, trigger automations, and list entities.Last updated -443JavaScriptMIT License