Home Assistant MCP Server
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:8123Related MCP server: Hass-MCP
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:
uv syncDistribuciones de paquetes de compilación:
uv buildEsto creará distribuciones de origen y de rueda en el directorio dist/ .
Publicar en PyPI:
uv publishNota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:
Token:
--tokenoUV_PUBLISH_TOKENO 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:
npx @modelcontextprotocol/inspector uv --directory /Users/miguel/Documents/home-assistant-server/home-assistant-server run home-assistant-serverAl 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 deployed
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
A TypeScript MCP server for Home Assistant, enabling programmatic management of entities, automati…
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
Related MCP Servers
- AlicenseBqualityCmaintenanceA 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.448MIT
- AlicenseAqualityAmaintenanceA Model Context Protocol server that enables AI assistants like Claude to interact directly with Home Assistant, allowing them to query device states, control smart home entities, and perform automation tasks.16345MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that allows large language models to control and query Home Assistant smart home systems through natural language interactions.29 npm5MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI assistants to control Philips Hue smart lighting systems through natural language commands.3MIT