Serveur MCP Home Assistant

Que fait le serveur MCP « Home Assistant » ?

Le Serveur MCP Home Assistant (hass-mcp) est un serveur Model Context Protocol (MCP) qui fait le pont entre les assistants IA – comme Claude ou d’autres LLM – et votre écosystème Home Assistant. En exposant les données et fonctionnalités de Home Assistant via le standard MCP, il permet aux agents IA d’interagir, d’interroger et de contrôler vos appareils domotiques et automatisations. Parmi les tâches typiques rendues possibles par hass-mcp : interrogation d’états d’appareils ou de capteurs, activation ou extinction de lumières/interrupteurs, synthèse de l’état du domicile, dépannage d’automatisations, recherche d’entités spécifiques, ou assistance guidée pour des activités courantes de la maison intelligente. Cette intégration améliore les workflows des développeurs et utilisateurs en rendant la gestion domotique accessible via l’IA conversationnelle, les automatisations et les agents LLM.

Liste des prompts

• Aucun modèle de prompt documenté n’a été trouvé dans le dépôt.

Liste des ressources

• Aucune ressource MCP explicite n’a été listée dans le dépôt.

Liste des outils

• Interroger l’état des appareils et capteurs : permet aux LLM de récupérer l’état actuel des entités Home Assistant.
• Contrôler lumières, interrupteurs et autres entités : permet un contrôle direct (on/off, luminosité, etc.) des composants domotiques pris en charge.
• Obtenir des résumés de votre maison intelligente : fournit une vue d’ensemble ou des informations agrégées sur l’état actuel du foyer.
• Diagnostiquer des automatisations et entités : offre des informations de diagnostic ou des étapes pour résoudre des problèmes d’automatisations ou d’entités.
• Rechercher des entités spécifiques : permet aux utilisateurs ou agents de localiser des appareils ou capteurs par nom ou type dans Home Assistant.
• Créer des conversations guidées pour des tâches courantes : prend en charge des interactions structurées pour accompagner l’utilisateur dans les opérations fréquentes de la maison intelligente.

Cas d’usage de ce serveur MCP

• Interrogation d’état d’appareils : les développeurs et utilisateurs peuvent demander programmatiquement ou de façon conversationnelle les états courants (ex : « La fenêtre de la cuisine est-elle ouverte ? ») pour la surveillance ou l’automatisation.
• Contrôle domotique : permet aux assistants vocaux ou chatbots d’allumer/éteindre des lumières, ajuster des thermostats, contrôler des appareils, améliorant accessibilité et automatisation.
• Rapports d’état du foyer : les LLM peuvent générer des synthèses quotidiennes ou à la demande (ex : « Quel est l’état de ma maison ce soir ? ») pour le confort utilisateur ou l’intégration à un tableau de bord.
• Dépannage des automatisations : les développeurs peuvent utiliser le serveur MCP pour identifier des erreurs ou mauvaises configurations dans les automatisations, facilitant le débogage.
• Recherche d’entités & flux guidés : localiser rapidement des appareils ou guider l’utilisateur à travers des routines multi-étapes (ex : « Configurer une routine du matin ») simplifie la gestion domotique.

Comment le configurer

Windsurf

1. Assurez-vous que Python et Docker sont installés sur votre système.
2. Clonez le dépôt hass-mcp et configurez la connexion à Home Assistant dans un fichier .env (voir .env.example).
3. Dans Windsurf, ouvrez la section MCP Servers des paramètres.
4. Ajoutez le serveur hass-mcp à l’aide d’une configuration JSON comme :

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

5. Enregistrez les paramètres et redémarrez Windsurf. Vérifiez que le serveur apparaît dans la liste MCP.

Claude

1. Déployez le serveur hass-mcp localement ou sur un serveur accessible à Claude.
2. Sécurisez votre clé API Home Assistant via des variables d’environnement.
3. Dans la configuration de Claude, ajoutez l’entrée du serveur MCP :

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

4. Redémarrez Claude et vérifiez la disponibilité du serveur MCP.
5. Utilisez des variables d’environnement pour sécuriser les données sensibles (voir ci-dessous).

Cursor

1. Déployez hass-mcp et assurez l’accès réseau entre Cursor et le serveur MCP.
2. Configurez Cursor pour utiliser le serveur MCP :

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

3. Enregistrez la configuration et redémarrez Cursor.
4. Définissez les variables d’environnement pour les clés API au besoin.

Cline

1. Installez les dépendances et exécutez le serveur hass-mcp (voir le dépôt pour détails).
2. Dans Cline, ouvrez votre fichier de configuration MCP.
3. Ajoutez le serveur hass-mcp :

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

4. Redémarrez Cline pour activer le nouveau serveur MCP.

Sécurisation des clés API (toutes plateformes) :

Utilisez des variables d’environnement dans votre configuration pour protéger les informations sensibles :

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

Comment utiliser ce MCP dans des flux

Utiliser MCP dans FlowHunt

Pour intégrer des serveurs MCP dans votre workflow FlowHunt, commencez par ajouter le composant MCP à votre flux et reliez-le à votre agent IA :

Cliquez sur le composant MCP pour ouvrir le panneau de configuration. Dans la section de configuration système MCP, insérez les détails de votre serveur MCP au format JSON suivant :

{
  "hass-mcp": {
    "transport": "streamable_http",
    "url": "https://votreserveurmcp.exemple/pathtothemcp/url"
  }
}

Une fois configuré, l’agent IA pourra utiliser ce MCP comme outil avec accès à toutes ses fonctions et capacités. N’oubliez pas de remplacer “hass-mcp” par le nom réel de votre serveur MCP et d’indiquer l’URL de votre propre serveur MCP.

Récapitulatif

Sur la base de la documentation et du contenu du dépôt, hass-mcp offre une base solide pour l’intégration Home Assistant via MCP, avec un support d’outils clair et de bonnes pratiques de configuration/sécurité. Cependant, il manque des modèles de prompts explicites, des définitions de ressources ou des fonctions avancées MCP dans la documentation publique. J’évalue ce serveur MCP à 6/10 : fonctionnel et adapté aux développeurs, mais sans documentation sur l’extensibilité ni fonctions MCP avancées.

Score MCP