Qu’est-ce que Sonoff MCP Server ?
Sonoff MCP Server, de l'utilisateur GitHub mrkutin, permet à un client MCP de piloter des appareils Sonoff via l'eWeLink Cloud API (CoolKit Open Platform v2). Il compte cinq outils : list_devices, get_device, switch_device, get_sensor_data et set_thermostat. Les appareils sont désignés par un nom partiel, sans tenir compte de la casse, et le serveur lit les paramètres eWeLink de chacun pour traiter interrupteurs, thermostats et capteurs avec un seul modèle ; le README cite les THR316D, MINIR4, SV et BASICR2.
C'est un serveur FastMCP en Python 3.12 lancé avec Docker Compose derrière votre propre reverse proxy HTTPS, pour que des clients hébergés comme claude.ai puissent l'atteindre, avec OAuth 2.0 et PKCE entre le client et le serveur. Son auteur s'en sert comme couche d'appareils derrière un assistant téléphonique à IA. Le code compte neuf commits entre février et juillet 2026 ; le dépôt est apparu sur GitHub le 13 novembre 2026, sans étoile, sans version publiée et sans fichier de licence.
Installer Sonoff MCP Server
git clone https://github.com/mrkutin/sonoff-mcp && cp .env.example .env && docker compose up -dSonoff MCP Server vaut-il le coup ?
Il n'existe pas de serveur MCP officiel de Sonoff, et le seul serveur communautaire eWeLink antérieur que nous ayons trouvé, 991glasses/ewelink-mcp-server, n'a plus eu de commit depuis juin 2025. Celui-ci est à jour et petit : cinq outils qui listent les appareils, lisent température et humidité, allument ou éteignent des appareils et règlent un thermostat sur chauffage, froid, déshumidification ou arrêt avec des seuils. Allumer ou éteindre un thermostat désactive aussi son mode automatique. Un relais Sonoff peut être branché sur n'importe quoi, d'une lampe à un radiateur ou une pompe, donc switch_device a autant de conséquences que ce qui se trouve au bout.
Chaque commande passe par le cloud. La chaîne va du client d'IA à votre serveur, puis au cloud eWeLink dans la région eu, us, as ou cn, puis à l'appareil ; rien ne parle directement aux appareils de votre réseau, donc les commandes échouent quand internet ou eWeLink tombe, et les données des appareils relèvent de la politique de confidentialité d'eWeLink. Le propriétaire du serveur autorise un compte eWeLink une fois via une page de configuration, et le serveur conserve les jetons de ce compte dans un fichier sur un volume Docker, avec les jetons MCP qu'il émet, écrits avec les permissions 0600.
Le contrôle d'accès est le point faible. La connexion du client est un vrai OAuth avec PKCE, mais la page de connexion demande un unique client ID et son secret définis dans l'environnement du serveur : qui les connaît contrôle tous les appareils du compte eWeLink. Il n'y a ni utilisateurs, ni scopes, ni outils en lecture seule. Une MCP_API_KEY facultative sert de jeton bearer qui n'expire jamais, ajoutée pour les appels de machine à machine. Le code montre du soin, avec des comparaisons à temps constant, l'échappement HTML et une liste blanche de régions, mais il n'a eu aucune revue externe, le dépôt ne contient aucun test et il n'a qu'un auteur.
L'absence de licence compte autant que le code. Sans elle, l'auteur n'a accordé aucun droit de copie ni de modification ; une entreprise devrait donc demander avant de bâtir dessus. Pour quelqu'un qui possède quelques appareils Sonoff, c'est un exemple lisible de connecteur MCP distant fait avec soin ; pour la plupart, Home Assistant avec l'intégration SonoffLAN et son propre serveur MCP offre un contrôle local et des droits plus fins.
Là où il fait la différence
Un développeur avec un thermostat Sonoff THR316D et deux relais connectés
Allumer le chauffage depuis Claude sur le chemin du retour
Enregistrez une app personnelle gratuite sur dev.ewelink.cc, lancez le conteneur derrière un proxy HTTPS, autorisez eWeLink une fois, puis ajoutez le serveur comme connecteur Claude. Comptez une soirée de configuration ; il n'existe pas de version hébergée.
Un maker qui construit un assistant vocal ou téléphonique
Donner à un LLM un petit ensemble sûr d'actions sur les appareils
Appelez les cinq outils avec MCP_API_KEY, comme le fait l'assistant téléphonique de l'auteur. Changez vous-même cette clé, puisqu'elle n'expire jamais, et laissez les relais des charges critiques hors du compte eWeLink utilisé par le serveur.
Avant de vous engager
- Mise en route
- Enregistrez une app sur dev.ewelink.cc pour obtenir un app ID et un secret, copiez .env.example en .env avec ces valeurs, un client ID et un secret MCP et votre URL publique, lancez docker compose up -d derrière un reverse proxy TLS, puis ouvrez /ewelink/setup une fois pour autoriser votre compte eWeLink.
- Intégrations
- Cinq outils : list_devices, get_device, switch_device, get_sensor_data et set_thermostat. HTTP en streaming pour Claude Code, claude.ai et d'autres clients MCP distants. En amont, uniquement l'eWeLink Cloud API v2 ; pas de contrôle en réseau local ni de prise en charge d'eWeLink CUBE.
- Données et confidentialité
- Conserve un secret d'app eWeLink, les jetons OAuth du compte et ses propres jetons MCP sur un volume Docker (fichiers de jetons écrits en 0600). Noms, états et relevés des appareils passent par le cloud eWeLink et vont au fournisseur d'IA. Quiconque détient le secret client MCP ou la MCP_API_KEY peut commuter tous les appareils du compte.
- Coût à grande échelle
- Gratuit hors hébergement. Le niveau développeur personnel d'eWeLink est gratuit mais limité à OAuth, avec un nombre restreint d'appels d'API et sans garantie de stabilité ; l'usage commercial exige l'offre entreprise payante d'eWeLink, sur devis.
- Limites
- Un compte eWeLink par serveur et un seul identifiant client partagé. Les appareils hors ligne ont droit à deux nouvelles tentatives à deux secondes d'intervalle, puis à une erreur. Les jetons d'accès MCP durent 24 heures et les refresh tokens ne sont pas pris en charge : les clients se reconnectent chaque jour.
Les points forts
- Fonctionne avec les clients hébergés via OAuth 2.0 et PKCE
- Recherche d'appareils par nom parmi interrupteurs et thermostats
- Relance les commandes vers les appareils qui se déconnectent
- Code court et lisible, avec des correctifs de sécurité dans son historique
Les points faibles
- Un seul secret client partagé contrôle tous les appareils
- Ni mode lecture seule, ni scopes, ni limites par appareil
- Cloud uniquement ; échoue quand eWeLink ou internet tombe
- Pas encore de licence, de versions, de tests ni d'autres utilisateurs
Idéal pour
Développeurs possédant des appareils Sonoff sur eWeLink qui veulent un connecteur MCP distant petit et lisible à adapter à leur usage.
Alternatives à Sonoff MCP Server
Sonoff MCP Server : questions fréquentes
- Sonoff MCP Server vaut-il le coup ?
- Un projet personnel soigné qui commute vraiment des appareils Sonoff depuis Claude, mais un seul mot de passe partagé, aucun mode lecture seule et aucune licence en font un point de départ plutôt qu'un logiciel à installer tel quel. Nous lui donnons 2.9 sur 5.
- Combien coûte Sonoff MCP Server ?
- Gratuit à exécuter ; le code n'a pas de fichier de licence. Le niveau développeur personnel d'eWeLink est gratuit, avec des appels d'API limités.
- Quels sont les inconvénients de Sonoff MCP Server ?
- Un seul secret client partagé contrôle tous les appareils; ni mode lecture seule, ni scopes, ni limites par appareil; cloud uniquement ; échoue quand eWeLink ou internet tombe; pas encore de licence, de versions, de tests ni d'autres utilisateurs.
- À qui s’adresse Sonoff MCP Server ?
- Développeurs possédant des appareils Sonoff sur eWeLink qui veulent un connecteur MCP distant petit et lisible à adapter à leur usage.
- Combien coûte Sonoff MCP Server pour une équipe ou en production ?
- Gratuit hors hébergement. Le niveau développeur personnel d'eWeLink est gratuit mais limité à OAuth, avec un nombre restreint d'appels d'API et sans garantie de stabilité ; l'usage commercial exige l'offre entreprise payante d'eWeLink, sur devis.
- Sonoff MCP Server est-il sûr pour les données de l’entreprise ?
- Conserve un secret d'app eWeLink, les jetons OAuth du compte et ses propres jetons MCP sur un volume Docker (fichiers de jetons écrits en 0600). Noms, états et relevés des appareils passent par le cloud eWeLink et vont au fournisseur d'IA. Quiconque détient le secret client MCP ou la MCP_API_KEY peut commuter tous les appareils du compte.
- Quelles sont les meilleures alternatives à Sonoff MCP Server ?
- Les alternatives les plus proches que nous avons testées sont Home Assistant MCP Server, HA-MCP et Aqara MCP Server.
Réponses vérifiées le 16 nov. 2026.