freebox-mcp-server

<p align="center"> </p>

Serveur MCP pour l'API Freebox OS - Contrôlez votre Freebox Server directement depuis les assistants IA compatibles MCP (Claude, Cursor, etc.). Créé par loopion.

Ce serveur expose de manière native et unifiée les API de votre Freebox (Revolution, Mini 4K, Pop, Delta, Ultra) via le Model Context Protocol (MCP), ouvrant la voie à une domotique pilotée par l'Intelligence Artificielle.

Le serveur MCP vient équipé avec des dizaines d'outils ("tools") prêts à être utilisés par l'IA :

• 🔐 Authentification :
• freebox_discover / freebox_register_app / freebox_login / freebox_logout
• 🖥️ Système :
• freebox_system_info (Version, Températures, Uptime, etc.)
• freebox_reboot
• 🌐 Réseau & Connexion Internet :
• freebox_connection_status / freebox_connection_config
• Gestion du WiFi (freebox_wifi_status, freebox_wifi_toggle, freebox_wifi_stations)
• Configuration LAN (freebox_lan_config, freebox_lan_hosts, freebox_wol)
• Paramétrage DHCP (freebox_dhcp_config, gestion des réservations freebox_dhcp_static_leases)
• Redirections de port (freebox_port_forwarding_list, etc.)
• 📁 Fichiers & Téléchargements :
• Gestion documentaire HTTP/FTP (freebox_downloads_list, freebox_download_add)
• Pilote du Disque Dur (freebox_fs_list, freebox_fs_info, freebox_fs_mkdir, moves, renames)

---

Assurez-vous d'avoir Node.js 18+ installé sur votre machine.

# Lance et télécharge le serveur automatiquement à l'aide de npx
npx -y freebox-mcp-server

Ouvrez le fichier de configuration de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json sur Mac ou %APPDATA%\Claude\claude_desktop_config.json sur Windows) et