hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integrations
Provides tools for controlling various Home Assistant domains including lights (on/off, brightness), climate systems (temperature, HVAC modes), locks (lock/unlock), alarm control panels (arm/disarm), and humidifiers (humidity control).
Servidor MCP de Home Assistant
Un proyecto de servidor de Protocolo de Contexto de Modelo (MCP) que se integra con Home Assistant para brindar capacidades de control de hogares inteligentes.
Indicaciones
El servidor proporciona indicaciones para el conjunto de herramientas de cada dominio.
Herramientas
El servidor implementa el control de varios dominios de Home Assistant. Actualmente es compatible con:
- 💡 Luces: Encender/apagar, control de brillo
- 🌡️ Clima: Control de temperatura, modos HVAC
- 🔒 Bloqueos: Funcionalidad de bloqueo/desbloqueo
- 🚨 Panel de control de alarma: Armar/desarmar sistemas de seguridad
- 💧 Humidificador: Control de humedad
Las herramientas de ejemplo incluyen:
Configuración
Variables de entorno
Cree un archivo .env en el directorio raíz con:
Inicio rápido
Instalar
Siga las instrucciones sobre cómo instalar Home Assistant y obtener un token de acceso de larga duración.
Escritorio de Claude
En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json
Desarrollo
Construcción y publicación
Para preparar el paquete para su distribución:
- Sincronizar dependencias y actualizar el archivo de bloqueo:
- Distribuciones de paquetes de compilación:
Esto creará distribuciones de origen y de rueda en el directorio dist/ .
- Publicar en PyPI:
Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:
- Token:
--tokenoUV_PUBLISH_TOKEN - O nombre de usuario/contraseña:
--username/UV_PUBLISH_USERNAMEy--password/UV_PUBLISH_PASSWORD
Depuración
Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .
Puede iniciar el Inspector MCP a través de npm con este comando:
Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.
Contribuyendo
¡Gracias por tu interés en contribuir a este proyecto!
Consulte CONTRIBUTING.md para obtener pautas.
Licencia
Licencia MIT: consulte LICENCIA para obtener más detalles.
This server cannot be installed
Un servidor de protocolo de contexto de modelo que se integra con Home Assistant para brindar capacidades de control de hogares inteligentes a través del lenguaje natural, compatible con dispositivos como luces, sistemas de climatización, cerraduras, alarmas y humidificadores.