Home Assistant MCP Server

# 🚀 Installation Rapide sur Raspberry Pi ## Installation Automatique (Recommandée) ### 1. Connexion SSH au Raspberry Pi ```bash ssh pi@IP_DU_RPI # ou ssh votre_utilisateur@IP_DU_RPI ``` ### 2. Installation en une commande ```bash curl -fsSL https://raw.githubusercontent.com/Jonathan97480/McpHomeAssistant/master/install.sh | bash ``` ### 3. Accès à l'interface - **URL** : http://IP_DU_RPI:8080 - **Login** : admin - **Password** : Admin123! ⚠️ **Changez immédiatement le mot de passe !** --- ## Installation Manuelle ### 1. Cloner le projet ```bash cd ~ git clone https://github.com/Jonathan97480/McpHomeAssistant.git cd McpHomeAssistant chmod +x install.sh ./install.sh ``` Ou installation complète automatique : ```bash sudo apt update && sudo apt install python3-pip python3-venv git -y python3 -m venv venv source venv/bin/activate pip install fastapi uvicorn pydantic httpx aiohttp cryptography bcrypt python-jose[cryptography] python-multipart passlib email-validator requests ``` ### 2. Démarrer le serveur ```bash python3 start_server.py ``` ### 3. Tester l'installation ```bash python3 test_simple.py ``` --- ## 🔧 Configuration Home Assistant 1. **Générer un token Long-Term** dans Home Assistant : - Profil → Tokens d'accès de longue durée → Créer un token 2. **Configurer dans l'interface web** : - Aller sur http://IP_DU_RPI:8080 - Se connecter avec admin/Admin123! - Menu **Configuration** → Ajouter Home Assistant - URL : `http://IP_HOME_ASSISTANT:8123` - Token : Coller le token généré - Tester la connexion --- ## 🛠️ Commandes Utiles ### Service (si installé) ```bash sudo systemctl status mcpbridge # Voir le statut sudo systemctl restart mcpbridge # Redémarrer sudo systemctl stop mcpbridge # Arrêter sudo journalctl -u mcpbridge -f # Logs en temps réel ``` ### Manuel ```bash cd ~/McpHomeAssistant source venv/bin/activate python3 start_server.py # Démarrer manuellement python3 test_complete.py # Tests complets ``` ### Debugging ```bash # Logs détaillés python3 bridge_server.py --log-level debug # Test de connexion curl http://localhost:8080/health # Vérifier les ports sudo netstat -tulpn | grep :8080 ``` --- ## ⚠️ Résolution de Problèmes ### Port déjà utilisé ```bash # Changer le port dans start_server.py nano start_server.py # Modifier port=8080 vers port=8081 ``` ### Erreurs de permissions ```bash sudo chown -R $USER:$USER ~/McpHomeAssistant chmod +x start_server.py ``` ### Mémoire insuffisante ```bash # Ajouter du swap sudo fallocate -l 1G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile ``` ### Base de données corrompue ```bash rm bridge_data.db # Redémarrer le serveur pour recréer la DB ``` --- ## 📊 Fonctionnalités Disponibles ### ✅ Interface Web Complète - **Dashboard** avec métriques temps réel - **Gestion des permissions** par outil MCP - **Configuration Home Assistant** multi-instance - **Visualisation des logs** avec filtrage - **Panel d'administration** utilisateurs - **Tests des outils MCP** en direct ### ✅ API REST Complète - **15+ endpoints** pour toutes les fonctionnalités - **Authentification JWT** sécurisée - **Export de données** CSV/JSON - **Monitoring système** intégré ### ✅ Sécurité Intégrée - **Authentification** utilisateur obligatoire - **Permissions granulaires** READ/WRITE/EXECUTE - **Chiffrement des tokens** Home Assistant - **Firewall** configuré automatiquement --- ## 🎯 Prêt pour Production Cette version est stable et prête pour utilisation avec votre Home Assistant ! **Support** : Consultez `RASPBERRY_PI_INSTALL.md` pour le guide complet **GitHub** : https://github.com/Jonathan97480/McpHomeAssistant