Skip to main content
Glama

Home Assistant MCP Server

by miguelg719

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

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:

  1. Sincronizar dependencias y actualizar el archivo de bloqueo:
uv sync
  1. Distribuciones de paquetes de compilación:
uv build

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

  1. 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.

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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.

  1. Indicaciones
    1. Herramientas
      1. Configuración
        1. Variables de entorno
      2. Inicio rápido
        1. Instalar
      3. Desarrollo
        1. Construcción y publicación
        2. Depuración
      4. Contribuyendo
        1. Licencia

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            Expose all Home Assistant voice intents through a Model Context Protocol Server allowing home control.
            Last updated -
            30
            Python
            Apache 2.0
          • A
            security
            A
            license
            A
            quality
            A 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 -
            4
            29
            JavaScript
            MIT License
            • Apple
          • -
            security
            F
            license
            -
            quality
            A versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.
            Last updated -
            2
            Python
            • Apple
            • Linux
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol (MCP) integration that allows AI assistants to control Home Assistant devices by searching for entities and controlling devices through natural language commands.
            Last updated -
            10
            Python
            MIT License
            • Linux
            • Apple

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/miguelg719/home-assistant-mcp'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server