Servidor MCP de Home Assistant

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con Home Assistant. Este servidor proporciona herramientas para controlar y supervisar sus dispositivos Home Assistant mediante aplicaciones compatibles con MCP.

Este proyecto forma parte del ecosistema del Protocolo de Contexto de Modelo de IA (MCP). Para más información y documentación sobre las herramientas MCP, visite www.aimcp.info .

Características

Obtener estados del dispositivo
Estados del dispositivo de control (encendido/apagado)
Automatizaciones de activación
Lista de entidades disponibles

Instalación

Clonar este repositorio:

git clone https://github.com/yourusername/homeassistant-server-mcp.git
cd homeassistant-server-mcp

Instalar dependencias:

npm install

Construir el proyecto:

npm run build

Configure el servidor MCP agregando lo siguiente a su archivo de configuración de MCP (normalmente ubicado en ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json para VSCode):

{
  "mcpServers": {
    "homeassistant": {
      "command": "node",
      "args": ["/path/to/homeassistant-mcp/homeassistant-server/build/index.js"],
      "env": {
        "HA_URL": "http://your-homeassistant-url:8123",
        "HA_TOKEN": "your-long-lived-access-token"
      }
    }
  }
}

Reemplace your-homeassistant-url y your-long-lived-access-token con la URL de su instancia de Home Assistant y el token de acceso.

Uso

El servidor proporciona las siguientes herramientas:

1. Obtener el estado del dispositivo

// Example usage
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "get_state",
  arguments: {
    entity_id: "light.living_room"
  }
});

2. Alternar estado del dispositivo

// Example usage
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "toggle_entity",
  arguments: {
    entity_id: "switch.bedroom",
    state: "on"  // or "off"
  }
});

3. Automatización de activadores

// Example usage
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "trigger_automation",
  arguments: {
    automation_id: "automation.morning_routine"
  }
});

4. Entidades de lista

// Example usage
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "list_entities",
  arguments: {
    domain: "light"  // optional, filters by domain
  }
});

Contribuyendo

¡Agradecemos tus contribuciones! Puedes ayudarnos de la siguiente manera:

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Asegúrese de actualizar las pruebas según corresponda y seguir el estilo del código existente.

Documentación

Para obtener documentación detallada sobre las herramientas MCP y el ecosistema:

Visita www.aimcp.info
Consulte el directorio de herramientas MCP en el sitio web
Lea las guías de integración y las mejores prácticas

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte a continuación para obtener más detalles:

MIT License

Copyright (c) 2024 homeassistant-mcp

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Seguridad

Para utilizar este servidor de forma segura:

Utilice siempre HTTPS para su instancia de Home Assistant
Mantenga sus tokens de acceso seguros y nunca los comprometa con el control de versiones
Gire periódicamente sus tokens de acceso
Utilice variables de entorno para información confidencial

Apoyo

Si tiene algún problema o pregunta, por favor:

Verifique los problemas existentes en el repositorio
Crea un nuevo problema si tu problema no ha sido reportado
Proporcione tanto contexto como sea posible al informar problemas.
Visite www.aimcp.info para obtener recursos de soporte adicionales

Home Assistant MCP Server

Integrations