Servidor MCP do Home Assistant

O que faz o Servidor MCP do “Home Assistant”?

O Servidor MCP do Home Assistant (hass-mcp) é um servidor Model Context Protocol (MCP) que conecta assistentes de IA — como o Claude e outros LLMs — ao seu ecossistema Home Assistant. Ao expor dados e funcionalidades do Home Assistant via o padrão MCP, ele permite que agentes de IA interajam, consultem e controlem dispositivos e automações da casa inteligente. Tarefas típicas habilitadas pelo hass-mcp incluem consultar estados de dispositivos e sensores, acionar luzes ou interruptores, resumir o status da residência, solucionar problemas de automações, buscar entidades específicas e facilitar conversas guiadas para atividades comuns de casa inteligente. Essa integração aprimora fluxos de trabalho de desenvolvedores e usuários, tornando o gerenciamento doméstico inteligente acessível por IA conversacional, automações e agentes baseados em LLM.

Lista de Prompts

• Nenhum template de prompt documentado foi encontrado no repositório.

Lista de Recursos

• Nenhum recurso MCP explícito foi listado no repositório.

Lista de Ferramentas

• Consultar o estado de dispositivos e sensores: Permite que LLMs recuperem o status atual de entidades do Home Assistant.
• Controlar luzes, interruptores e outros dispositivos: Habilita controle direto (ligar/desligar, brilho, etc.) de componentes inteligentes suportados.
• Obter resumos da sua casa inteligente: Fornece visões gerais ou informações agregadas sobre o estado atual da casa.
• Solucionar problemas de automações e entidades: Oferece diagnósticos ou etapas para resolver problemas com automações ou dispositivos.
• Buscar entidades específicas: Permite que usuários ou agentes localizem dispositivos ou sensores pelo nome ou tipo no Home Assistant.
• Criar conversas guiadas para tarefas comuns: Suporta interações estruturadas para orientar usuários em operações frequentes da casa inteligente.

Casos de Uso deste Servidor MCP

• Consulta de Estado de Dispositivos: Desenvolvedores e usuários podem requisitar programaticamente ou por chat os estados atuais (ex: “A janela da cozinha está aberta?”), apoiando monitoramento e lógicas de automação.
• Controle da Casa Inteligente: Permite que assistentes de voz ou chatbots liguem/desliguem luzes, ajustem termostatos ou controlem eletrodomésticos, melhorando acessibilidade e automação.
• Relatórios Resumidos da Casa: LLMs podem gerar resumos diários ou sob demanda (ex: “Qual o status da minha casa esta noite?”) para comodidade do usuário ou integração em dashboards.
• Solução de Problemas em Automações: Desenvolvedores podem usar o servidor MCP para identificar erros ou falhas em automações, facilitando o debugging.
• Busca de Entidades & Flows Guiados: Localizar rapidamente dispositivos ou guiar usuários por rotinas complexas (ex: “Configurar rotina matinal”) simplifica o gerenciamento da casa inteligente.

Como configurar

Windsurf

1. Certifique-se de que Python e Docker estejam instalados em seu sistema.
2. Clone o repositório hass-mcp e configure a conexão com o Home Assistant em um arquivo .env (exemplo em .env.example).
3. No Windsurf, abra a seção de MCP Servers nas configurações.
4. Adicione o servidor hass-mcp usando a configuração JSON:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "docker",
         "args": ["run", "--env-file=.env", "-p", "8080:8080", "voska/hass-mcp:latest"]
       }
     }
   }
   

5. Salve as configurações e reinicie o Windsurf. Verifique se o servidor aparece na lista MCP.

Claude

1. Faça o deploy do servidor hass-mcp localmente ou em um servidor acessível ao Claude.
2. Proteja sua chave de API do Home Assistant usando variáveis de ambiente.
3. Na configuração do Claude, adicione a entrada do servidor MCP:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. Reinicie o Claude e verifique a disponibilidade do servidor MCP.
5. Use variáveis de ambiente para proteger dados sensíveis (veja abaixo).

Cursor

1. Faça o deploy do hass-mcp e garanta acesso de rede entre o Cursor e o servidor MCP.
2. Configure o Cursor para utilizar o servidor MCP:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

3. Salve a configuração e reinicie o Cursor.
4. Defina variáveis de ambiente para as chaves de API se necessário.

Cline

1. Instale as dependências e execute o servidor hass-mcp (veja o repositório para detalhes).
2. No Cline, abra seu arquivo de configuração MCP.
3. Adicione o servidor hass-mcp:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. Reinicie o Cline para habilitar o novo servidor MCP.

Protegendo Chaves de API (Todas as Plataformas):

Use variáveis de ambiente em sua configuração para proteger informações sensíveis:

{
  "mcpServers": {
    "hass-mcp": {
      "env": {
        "HASS_TOKEN": "${HASS_TOKEN}"
      },
      "inputs": {
        "hass_url": "http://your-homeassistant.local:8123"
      }
    }
  }
}

Como usar este MCP dentro de flows

Usando MCP no FlowHunt

Para integrar servidores MCP em seu fluxo FlowHunt, adicione o componente MCP ao seu fluxo e conecte-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do sistema MCP, insira os detalhes do seu servidor MCP neste formato JSON:

{
  "hass-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Depois de configurado, o agente de IA poderá usar este MCP como uma ferramenta com acesso a todas suas funções e capacidades. Lembre-se de trocar “hass-mcp” pelo nome real do seu servidor MCP e substituir a URL pela do seu servidor.

Visão Geral

Com base na documentação disponível e conteúdo do repositório, o hass-mcp oferece uma base sólida para integração do Home Assistant via MCP, com suporte claro a ferramentas e práticas sensatas de configuração/segurança. No entanto, há ausência de templates de prompt explícitos, definições de recursos ou funcionalidades avançadas de sampling/roots na documentação pública. Eu avaliaria este servidor MCP com 6/10: funcional e amigável para desenvolvedores, mas faltando documentação de extensibilidade e recursos MCP avançados.

Score MCP