Home Assistant MCP Server

# 🎯 Guide de Déploiement Final - Phase 3.4 ## 📋 Résumé du Projet **McP Bridge - Interface Web Complète** est maintenant prêt pour le déploiement en production sur Raspberry Pi. Cette version inclut : ### ✅ Fonctionnalités Implémentées - **Interface Web Complète** avec 9 pages fonctionnelles - **API REST** avec 25+ endpoints - **Système d'authentification** JWT sécurisé - **Gestion des permissions** granulaire par outil - **Configuration multi-instances** Home Assistant - **Dashboard temps réel** avec métriques - **Logs centralisés** avec filtrage avancé - **Tests automatisés** et validation - **Installation automatisée** pour Raspberry Pi --- ## 🚀 Déploiement Rapide ### Option 1: Installation Automatique (Recommandée) ```bash # Connexion SSH au Raspberry Pi ssh pi@IP_DU_RPI # Installation en une commande curl -fsSL https://raw.githubusercontent.com/Jonathan97480/McpHomeAssistant/master/install.sh | bash ``` ### Option 2: Installation Manuelle ```bash # 1. Cloner et installer git clone https://github.com/Jonathan97480/McpHomeAssistant.git cd McpHomeAssistant chmod +x install.sh ./install.sh # 2. Tester l'installation python3 test_simple.py ``` ### Option 3: Installation Pas-à-Pas Voir `RASPBERRY_PI_INSTALL.md` pour le guide détaillé. --- ## 🌐 Accès à l'Interface Une fois installé : 1. **Ouvrir le navigateur** : `http://IP_DU_RPI:8080` 2. **Se connecter** : - Utilisateur : `admin` - Mot de passe : `Admin123!` 3. **⚠️ Changer immédiatement le mot de passe** --- ## 🏠 Configuration Home Assistant ### 1. Générer un Token dans Home Assistant - Aller dans **Profil** → **Tokens d'accès de longue durée** - Cliquer sur **Créer un token** - Copier le token généré ### 2. Configurer dans McP Bridge - Menu **Configuration** → **Home Assistant** - Ajouter une nouvelle instance : - **Nom** : Maison (ou autre) - **URL** : `http://IP_HOME_ASSISTANT:8123` - **Token** : Coller le token - **Cliquer sur "Tester"** pour valider - **Sauvegarder** ### 3. Configurer les Permissions - Menu **Permissions** - Sélectionner les outils MCP autorisés - Définir les permissions READ/WRITE/EXECUTE - Sauvegarder les modifications --- ## 🛠️ Administration du Service ### Commandes SystemD (si service installé) ```bash # Voir le statut sudo systemctl status mcpbridge # Démarrer/Arrêter/Redémarrer sudo systemctl start mcpbridge sudo systemctl stop mcpbridge sudo systemctl restart mcpbridge # Voir les logs en temps réel sudo journalctl -u mcpbridge -f # Voir les logs complets sudo journalctl -u mcpbridge --no-pager ``` ### Démarrage Manuel ```bash cd ~/McpHomeAssistant source venv/bin/activate python3 start_server.py ``` ### Tests et Validation ```bash # Test rapide python3 test_simple.py # Tests complets python3 test_complete.py # Test de santé via API curl http://localhost:8080/health ``` --- ## 📊 Monitoring et Logs ### Interface Web - **Dashboard** : Métriques système temps réel - **Logs** : Visualisation et filtrage des événements - **Admin Panel** : Gestion des utilisateurs et permissions ### Ligne de Commande ```bash # Logs du service sudo journalctl -u mcpbridge -f # Logs d'erreur uniquement sudo journalctl -u mcpbridge -p err # Utilisation CPU/Mémoire htop ps aux | grep python # Espace disque df -h du -sh ~/McpHomeAssistant ``` --- ## 🔧 Résolution de Problèmes ### Port déjà utilisé ```bash # Changer le port dans start_server.py nano ~/McpHomeAssistant/start_server.py # Modifier port=8080 vers port=8081 ``` ### Problèmes de mémoire ```bash # Ajouter du swap (512MB) sudo fallocate -l 512M /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile ``` ### Base de données corrompue ```bash cd ~/McpHomeAssistant rm bridge_data.db sudo systemctl restart mcpbridge ``` ### Problèmes de permissions ```bash sudo chown -R $USER:$USER ~/McpHomeAssistant chmod +x ~/McpHomeAssistant/*.py ``` --- ## 📈 Performance et Optimisation ### Raspberry Pi 3B+ / 4 - **RAM** : 1GB minimum, 2GB+ recommandé - **Stockage** : 8GB minimum, 16GB+ recommandé - **Réseau** : Ethernet recommandé vs WiFi ### Optimisations ```bash # Augmenter la limite de fichiers ouverts echo "* soft nofile 65536" | sudo tee -a /etc/security/limits.conf echo "* hard nofile 65536" | sudo tee -a /etc/security/limits.conf # Optimiser la mémoire virtuelle echo "vm.swappiness=10" | sudo tee -a /etc/sysctl.conf ``` --- ## 🔒 Sécurité ### Recommandations 1. **Changer le mot de passe par défaut** immédiatement 2. **Utiliser HTTPS** en production (avec reverse proxy) 3. **Configurer le firewall** correctement 4. **Mettre à jour** régulièrement le système 5. **Sauvegarder** la base de données `bridge_data.db` ### Firewall UFW ```bash sudo ufw enable sudo ufw allow ssh sudo ufw allow 8080/tcp sudo ufw status ``` --- ## 📚 Documentation Complète | Fichier | Description | |---------|-------------| | `QUICK_INSTALL_RPI.md` | Installation rapide | | `RASPBERRY_PI_INSTALL.md` | Guide détaillé | | `PHASE_3_4_SUMMARY.md` | Résumé technique | | `ROADMAP.md` | Feuille de route | --- ## 🎉 Phase 3.4 - Accomplissements ### Frontend Web - ✅ **9 pages HTML** complètes et responsive - ✅ **Framework CSS** personnalisé (700+ lignes) - ✅ **SPA JavaScript** moderne (700+ lignes) - ✅ **Design responsive** mobile-friendly - ✅ **Animations et interactions** fluides ### Backend API - ✅ **25+ endpoints REST** documentés - ✅ **Authentification JWT** sécurisée - ✅ **Gestion des permissions** granulaire - ✅ **Multi-instances** Home Assistant - ✅ **Métriques temps réel** système ### DevOps - ✅ **Installation automatisée** Raspberry Pi - ✅ **Service SystemD** intégré - ✅ **Tests automatisés** complets - ✅ **Documentation** complète - ✅ **Scripts de déploiement** prêts --- ## ➡️ Prochaines Étapes (Phase 3.5) 1. **HTTPS/SSL** avec Let's Encrypt 2. **Reverse Proxy** Nginx/Apache 3. **Base de données** PostgreSQL 4. **Monitoring** Prometheus/Grafana 5. **Sauvegarde automatique** 6. **Mise à jour OTA** (Over-The-Air) --- **🚀 Le projet est maintenant prêt pour la production !** Support : Consultez la documentation ou ouvrez une issue sur GitHub.