¿Qué es Sonoff MCP Server?
Sonoff MCP Server, del usuario de GitHub mrkutin, permite a un cliente MCP controlar dispositivos Sonoff a través de la eWeLink Cloud API (CoolKit Open Platform v2). Tiene cinco herramientas: list_devices, get_device, switch_device, get_sensor_data y set_thermostat. Los dispositivos se identifican por un nombre parcial sin distinguir mayúsculas, y el servidor lee los parámetros de eWeLink de cada uno para tratar interruptores, termostatos y sensores con un solo modelo; el README cita el THR316D, MINIR4, SV y BASICR2.
Es un servidor FastMCP en Python 3.12 que se ejecuta con Docker Compose detrás de tu propio proxy inverso HTTPS, de modo que clientes alojados como claude.ai pueden llegar a él, con OAuth 2.0 y PKCE entre el cliente y el servidor. Su autor lo usa como capa de dispositivos de un asistente telefónico con IA. El código tiene nueve commits entre febrero y julio de 2026; el repositorio apareció en GitHub el 13 de noviembre de 2026 sin estrellas, sin versiones publicadas y sin archivo de licencia.
Cómo instalar Sonoff MCP Server
git clone https://github.com/mrkutin/sonoff-mcp && cp .env.example .env && docker compose up -d¿Merece la pena Sonoff MCP Server?
No existe un servidor MCP del fabricante para Sonoff, y el único servidor comunitario anterior para eWeLink que encontramos, 991glasses/ewelink-mcp-server, no tiene commits desde junio de 2025. Este está al día y es pequeño: cinco herramientas que listan dispositivos, leen temperatura y humedad, encienden o apagan dispositivos y ponen un termostato en calor, frío, deshumidificación o apagado con umbrales. Encender o apagar un termostato también desactiva su modo automático. Un relé Sonoff puede ir conectado a cualquier cosa, de una lámpara a un calefactor o una bomba, así que switch_device tiene tanta trascendencia como lo que haya al otro lado.
Cada comando pasa por la nube. La cadena es cliente de IA, tu servidor, la nube de eWeLink en la región eu, us, as o cn, y luego el dispositivo; nada habla directamente con los dispositivos de tu red, así que los comandos fallan cuando internet o eWeLink caen, y los datos de los dispositivos quedan sujetos a la política de privacidad de eWeLink. El dueño del servidor autoriza una cuenta de eWeLink una vez desde una página de configuración, y el servidor guarda los tokens de esa cuenta en un archivo de un volumen Docker, junto con los tokens MCP que emite, escritos con permisos 0600.
El control de acceso es el punto débil. El inicio de sesión del cliente es OAuth real con PKCE, pero la página de acceso pide un único client ID y secreto definidos en el entorno del servidor, así que quien los conozca controla todos los dispositivos de la cuenta de eWeLink; no hay usuarios, scopes ni herramientas de solo lectura. Una MCP_API_KEY opcional funciona como token bearer que nunca caduca, añadida para llamadas entre máquinas. El código muestra cuidado, con comparaciones en tiempo constante, escapado de HTML y una lista blanca de regiones, pero no ha tenido revisión externa, no hay tests en el repositorio y solo tiene un autor.
La falta de licencia pesa tanto como el código. Sin ella, el autor no ha concedido ningún derecho a copiarlo ni modificarlo, así que una empresa debería preguntar antes de construir sobre él. Para alguien con unos pocos dispositivos Sonoff es un ejemplo legible de conector MCP remoto hecho con cuidado; para la mayoría, Home Assistant con la integración SonoffLAN y su propio servidor MCP da control local y permisos más finos.
Dónde se gana su sitio
Un desarrollador con un termostato Sonoff THR316D y dos relés inteligentes
Encender la calefacción desde Claude de camino a casa
Registra una app personal gratuita en dev.ewelink.cc, ejecuta el contenedor detrás de un proxy HTTPS, autoriza eWeLink una vez y añade el servidor como conector de Claude. Cuenta con una tarde de configuración; no hay versión alojada.
Un maker que construye un asistente de voz o telefónico
Dar a un LLM un conjunto pequeño y seguro de acciones sobre dispositivos
Llama a las cinco herramientas con MCP_API_KEY, como hace el asistente telefónico del propio autor. Rota tú esa clave, porque nunca caduca, y deja los relés de cargas críticas fuera de la cuenta de eWeLink que usa el servidor.
Antes de decidirte
- Puesta en marcha
- Registra una app en dev.ewelink.cc para obtener un app ID y un secreto, copia .env.example a .env con esos datos, un client ID y secreto MCP y tu URL pública, ejecuta docker compose up -d detrás de un proxy inverso con TLS y abre /ewelink/setup una vez para autorizar tu cuenta de eWeLink.
- Integraciones
- Cinco herramientas: list_devices, get_device, switch_device, get_sensor_data y set_thermostat. HTTP en streaming para Claude Code, claude.ai y otros clientes MCP remotos. Solo usa la eWeLink Cloud API v2; sin control por LAN ni soporte para eWeLink CUBE.
- Datos y privacidad
- Guarda un secreto de app de eWeLink, los tokens OAuth de la cuenta y sus propios tokens MCP en un volumen Docker (archivos de tokens escritos con 0600). Nombres, estados y lecturas de los dispositivos pasan por la nube de eWeLink y llegan al proveedor de IA. Quien tenga el secreto de cliente MCP o la MCP_API_KEY puede conmutar todos los dispositivos de la cuenta.
- Coste a escala
- Gratis salvo el alojamiento. El nivel de desarrollador personal de eWeLink es gratuito pero solo con OAuth, con un número limitado de llamadas a la API y sin garantía de estabilidad; el uso comercial requiere el nivel empresarial de pago de eWeLink, con precio bajo petición.
- Límites
- Una cuenta de eWeLink por servidor y una única credencial de cliente compartida. Los dispositivos sin conexión reciben dos reintentos con dos segundos de separación y luego un error. Los tokens de acceso MCP duran 24 horas y no hay refresh tokens, así que los clientes vuelven a iniciar sesión cada día.
Lo bueno
- Funciona con clientes alojados mediante OAuth 2.0 y PKCE
- Búsqueda de dispositivos por nombre entre interruptores y termostatos
- Reintenta los comandos a dispositivos que se quedan sin conexión
- Código breve y legible, con correcciones de seguridad en su historial
Lo malo
- Un único secreto de cliente compartido controla todos los dispositivos
- Sin modo de solo lectura, scopes ni límites por dispositivo
- Solo nube; falla cuando eWeLink o internet caen
- Sin licencia, versiones, tests ni otros usuarios todavía
Ideal para
Desarrolladores con dispositivos Sonoff en eWeLink que quieren un conector MCP remoto pequeño y legible para adaptarlo a su uso.
Alternativas a Sonoff MCP Server
Sonoff MCP Server: preguntas frecuentes
- ¿Merece la pena Sonoff MCP Server?
- Un proyecto personal bien hecho que de verdad conmuta dispositivos Sonoff desde Claude, pero una sola contraseña compartida, ningún modo de solo lectura y ninguna licencia lo convierten en un punto de partida y no en algo para instalar tal cual. Le damos un 2.9 sobre 5.
- ¿Cuánto cuesta Sonoff MCP Server?
- Gratis de ejecutar; el código no tiene archivo de licencia. El nivel de desarrollador personal de eWeLink es gratuito, con llamadas a la API limitadas.
- ¿Qué inconvenientes tiene Sonoff MCP Server?
- Un único secreto de cliente compartido controla todos los dispositivos; sin modo de solo lectura, scopes ni límites por dispositivo; solo nube; falla cuando eWeLink o internet caen; sin licencia, versiones, tests ni otros usuarios todavía.
- ¿Para quién es Sonoff MCP Server?
- Desarrolladores con dispositivos Sonoff en eWeLink que quieren un conector MCP remoto pequeño y legible para adaptarlo a su uso.
- ¿Cuánto cuesta Sonoff MCP Server para un equipo o en producción?
- Gratis salvo el alojamiento. El nivel de desarrollador personal de eWeLink es gratuito pero solo con OAuth, con un número limitado de llamadas a la API y sin garantía de estabilidad; el uso comercial requiere el nivel empresarial de pago de eWeLink, con precio bajo petición.
- ¿Es Sonoff MCP Server seguro para los datos de la empresa?
- Guarda un secreto de app de eWeLink, los tokens OAuth de la cuenta y sus propios tokens MCP en un volumen Docker (archivos de tokens escritos con 0600). Nombres, estados y lecturas de los dispositivos pasan por la nube de eWeLink y llegan al proveedor de IA. Quien tenga el secreto de cliente MCP o la MCP_API_KEY puede conmutar todos los dispositivos de la cuenta.
- ¿Cuáles son las mejores alternativas a Sonoff MCP Server?
- Las alternativas más cercanas que hemos analizado son Home Assistant MCP Server, HA-MCP y Aqara MCP Server.
Respuestas comprobadas el 16 nov 2026.