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:

light-turn_on()
climate-turn_off()
alarm_control_panel-disarm()
lock-lock()
humidifier-turn_off()

Configuración

Variables de entorno

Cree un archivo .env en el directorio raíz con:

HOMEASSISTANT_TOKEN=your_long_lived_access_token_here # get it from your Home Assistant instance after onboarding
HOMEASSISTANT_BASE_URL=your_home_assistant_url_here # e.g. http://homeassistant.local:8123

Related MCP server: Home Assistant MCP

Inicio rápido

Instalar

Siga las instrucciones sobre cómo instalar Home Assistant y obtener un token de acceso de larga duración.

• Primeros pasos con Home Assistant

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:

1. Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync

2. Distribuciones de paquetes de compilación:

uv build

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

3. Publicar en PyPI:

uv publish

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:

• Token: --token o UV_PUBLISH_TOKEN

• O nombre de usuario/contraseña: --username / UV_PUBLISH_USERNAME y --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:

npx @modelcontextprotocol/inspector uv --directory /Users/miguel/Documents/home-assistant-server/home-assistant-server run home-assistant-server

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.