Serveur Mcp Home Assistant
Un serveur de protocole de contexte de modèle pour Home Assistant
Aperçu
Qu'est-ce que le serveur MCP pour Home Assistant ?
Le serveur MCP pour Home Assistant est un serveur spécialisé conçu pour faciliter l'intégration du Protocole de Contexte de Modèle (MCP) au sein de l'écosystème Home Assistant. Ce serveur agit comme un pont, permettant une communication fluide entre divers appareils de maison intelligente et la plateforme Home Assistant, améliorant ainsi les capacités d'automatisation et de contrôle.
Caractéristiques du serveur MCP pour Home Assistant
- Intégration avec Home Assistant : Le serveur MCP permet une intégration facile avec Home Assistant, offrant aux utilisateurs une interface unifiée pour gérer leurs appareils de maison intelligente.
- Communication en temps réel : Il prend en charge l'échange de données en temps réel, garantissant que les commandes et les mises à jour sont traitées instantanément, ce qui est crucial pour les applications sensibles au temps.
- Interface conviviale : Le serveur est livré avec un processus de configuration simple et une interface utilisateur intuitive, le rendant accessible même pour ceux qui ont des connaissances techniques limitées.
- Open Source : Étant un projet open-source, les utilisateurs peuvent contribuer à son développement, le personnaliser selon leurs besoins, ou même le forker pour un usage personnel.
- Support communautaire : Le serveur MCP bénéficie d'une communauté dynamique d'utilisateurs et de développeurs qui fournissent un soutien, partagent des expériences et contribuent à son amélioration continue.
Comment configurer le serveur MCP pour Home Assistant
- Installation : Commencez par télécharger le serveur MCP depuis son dépôt GitHub. Suivez les instructions d'installation fournies dans la documentation.
- Configuration : Une fois installé, configurez les paramètres du serveur pour correspondre à votre configuration Home Assistant. Cela peut inclure la configuration des paramètres réseau et des connexions d'appareils.
- Intégration : Ajoutez le serveur MCP à votre configuration Home Assistant. Cela implique généralement de modifier le fichier configuration.yaml pour inclure l'intégration MCP.
- Test : Après la configuration, testez le serveur pour vous assurer qu'il communique efficacement avec votre configuration Home Assistant et les appareils connectés.
- Personnalisation : Explorez des fonctionnalités supplémentaires et des options de personnalisation pour adapter le serveur à vos besoins spécifiques en matière de maison intelligente.
Questions Fréquemment Posées
Q : Le serveur MCP est-il compatible avec tous les appareils de maison intelligente ?
R : Le serveur MCP est conçu pour fonctionner avec une large gamme d'appareils de maison intelligente, mais la compatibilité peut varier. Consultez la documentation pour une liste des appareils pris en charge.
Q : Puis-je contribuer au projet du serveur MCP ?
R : Oui ! Le serveur MCP est un projet open-source, et les contributions sont les bienvenues. Vous pouvez signaler des problèmes, suggérer des fonctionnalités ou soumettre des améliorations de code via le dépôt GitHub.
Q : Quelles sont les exigences système pour faire fonctionner le serveur MCP ?
R : Le serveur MCP peut fonctionner sur diverses plateformes, y compris Raspberry Pi et d'autres systèmes basés sur Linux. Consultez le guide d'installation pour des exigences spécifiques.
Q : Comment résoudre les problèmes de connexion avec mes appareils ?
R : Si vous rencontrez des problèmes de connexion, vérifiez les journaux du serveur pour des messages d'erreur, assurez-vous que vos appareils sont sous tension et connectés au même réseau, et vérifiez vos paramètres de configuration.
Q : Existe-t-il une application mobile pour gérer le serveur MCP ?
R : Actuellement, il n'existe pas d'application mobile dédiée, mais vous pouvez gérer le serveur MCP via l'application mobile Home Assistant une fois qu'il est intégré.
Détail
mcp-server-home-assistant
A Model Context Protocol Server for Home Assistant. See Model Context Protocol for context.
The custom component required by this integration is moving to Home Assistant Core in https://github.com/home-assistant/core/pull/134122
Usage in Claude Desktop
-
Install the home-assistant-model-context-protocol custom component in your Home Assistant instance
-
Create a Long Lived Access Token
-
Clone this git repo to a path like
/Users/allen/Development/mcp-server-home-assistant
-
Edit your
claude_desktop_config.json
with something like this and include your home assistant url and api token:{ "mcpServers": { "Home-assistant": { "command": "uv", "args": [ "--directory", "/Users/allen/Development/mcp-server-home-assistant", "run", "mcp-server-home-assistant", "-v", "-v" ], "env": { "HOME_ASSISTANT_WEB_SOCKET_URL": "http://localhost:8123/api/websocket", "HOME_ASSISTANT_API_TOKEN": "byJhbVci0iJIUzI1ii1sInR5cCI6IkpXVCJ9..... } } } }
-
You can view the logs e.g.
~Library/Logs/Claude/mcp-server-Home-assistant.log
to understand what is happening
Configuration du serveur
{
"mcpServers": {
"mcp-server-home-assistant": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--allenporter--mcp-server-home-assistant--mcp-server-home-assistant",
"mcp-server-home-assistant"
],
"env": {
"HOME_ASSISTANT_WEB_SOCKET_URL": "home-assistant-web-socket-url"
}
}
}
}