O que é Sonoff MCP Server?
Sonoff MCP Server, do usuário do GitHub mrkutin, permite que um cliente MCP controle dispositivos Sonoff pela eWeLink Cloud API (CoolKit Open Platform v2). Ele tem cinco ferramentas: list_devices, get_device, switch_device, get_sensor_data e set_thermostat. Os dispositivos são identificados por parte do nome, sem diferenciar maiúsculas, e o servidor lê os parâmetros eWeLink de cada um para tratar interruptores, termostatos e sensores com um único modelo; o README cita THR316D, MINIR4, SV e BASICR2.
É um servidor FastMCP em Python 3.12 executado com Docker Compose atrás do seu próprio proxy reverso HTTPS, para que clientes hospedados como o claude.ai consigam alcançá-lo, com OAuth 2.0 e PKCE entre o cliente e o servidor. O autor o usa como camada de dispositivos por trás de um assistente telefônico com IA. O código tem nove commits entre fevereiro e julho de 2026; o repositório apareceu no GitHub em 13 de novembro de 2026, sem estrelas, sem releases e sem arquivo de licença.
Como instalar Sonoff MCP Server
git clone https://github.com/mrkutin/sonoff-mcp && cp .env.example .env && docker compose up -dSonoff MCP Server vale a pena?
Não existe servidor MCP do fabricante para Sonoff, e o único servidor comunitário anterior para eWeLink que encontramos, 991glasses/ewelink-mcp-server, não recebe commits desde junho de 2025. Este está em dia e é pequeno: cinco ferramentas que listam dispositivos, leem temperatura e umidade, ligam ou desligam dispositivos e colocam um termostato em aquecer, resfriar, desumidificar ou desligado, com limites. Ligar ou desligar um termostato também desativa o modo automático dele. Um relé Sonoff pode estar ligado a qualquer coisa, de uma lâmpada a um aquecedor ou uma bomba, então switch_device tem tanta consequência quanto o que estiver na outra ponta.
Todo comando passa pela nuvem. A cadeia é cliente de IA, seu servidor, a nuvem do eWeLink na região eu, us, as ou cn, e então o dispositivo; nada fala diretamente com os dispositivos da sua rede, então os comandos falham quando a internet ou o eWeLink caem, e os dados dos dispositivos ficam sujeitos à política de privacidade do eWeLink. O dono do servidor autoriza uma conta eWeLink uma vez por uma página de configuração, e o servidor guarda os tokens dessa conta em um arquivo num volume Docker, junto com os tokens MCP que emite, gravados com permissão 0600.
O controle de acesso é o ponto fraco. O login do cliente é OAuth de verdade com PKCE, mas a página de login pede um único client ID e segredo definidos no ambiente do servidor, então quem os conhece controla todos os dispositivos da conta eWeLink; não há usuários, escopos nem ferramentas somente leitura. Uma MCP_API_KEY opcional funciona como token bearer que nunca expira, adicionada para chamadas entre máquinas. O código mostra cuidado, com comparações em tempo constante, escape de HTML e uma lista de regiões permitidas, mas não passou por revisão externa, não há testes no repositório e só tem um autor.
A falta de licença pesa tanto quanto o código. Sem ela, o autor não concedeu nenhum direito de copiar ou modificar, então uma empresa deveria perguntar antes de construir em cima dele. Para quem tem alguns dispositivos Sonoff, é um exemplo legível de conector MCP remoto feito com cuidado; para a maioria, o Home Assistant com a integração SonoffLAN e o próprio servidor MCP oferece controle local e permissões mais finas.
Onde ele se destaca
Um desenvolvedor com um termostato Sonoff THR316D e dois relés inteligentes
Ligar o aquecimento pelo Claude a caminho de casa
Registre um app pessoal gratuito em dev.ewelink.cc, rode o contêiner atrás de um proxy HTTPS, autorize o eWeLink uma vez e adicione o servidor como conector do Claude. Conte com uma noite de configuração; não há versão hospedada.
Um maker construindo um assistente de voz ou telefônico
Dar a um LLM um conjunto pequeno e seguro de ações em dispositivos
Chame as cinco ferramentas com MCP_API_KEY, como faz o assistente telefônico do próprio autor. Troque essa chave você mesmo, já que ela nunca expira, e deixe relés de cargas críticas fora da conta eWeLink usada pelo servidor.
Antes de decidir
- Configuração
- Registre um app em dev.ewelink.cc para obter app ID e segredo, copie .env.example para .env com esses dados, um client ID e segredo MCP e sua URL pública, rode docker compose up -d atrás de um proxy reverso com TLS e abra /ewelink/setup uma vez para autorizar sua conta eWeLink.
- Integrações
- Cinco ferramentas: list_devices, get_device, switch_device, get_sensor_data e set_thermostat. HTTP em streaming para Claude Code, claude.ai e outros clientes MCP remotos. Na outra ponta, só a eWeLink Cloud API v2; sem controle pela rede local e sem suporte ao eWeLink CUBE.
- Dados e privacidade
- Guarda um segredo de app eWeLink, os tokens OAuth da conta e os próprios tokens MCP num volume Docker (arquivos de token gravados com 0600). Nomes, estados e leituras dos dispositivos passam pela nuvem do eWeLink e vão para o provedor de IA. Quem tiver o segredo de cliente MCP ou a MCP_API_KEY pode acionar todos os dispositivos da conta.
- Custo em escala
- Gratuito, fora a hospedagem. O nível de desenvolvedor pessoal do eWeLink é gratuito, mas só com OAuth, com número limitado de chamadas de API e sem garantia de estabilidade; uso comercial exige o nível empresarial pago do eWeLink, com preço sob consulta.
- Limites
- Uma conta eWeLink por servidor e uma única credencial de cliente compartilhada. Dispositivos offline recebem duas novas tentativas com dois segundos de intervalo e depois um erro. Os tokens de acesso MCP duram 24 horas e não há suporte a refresh tokens, então os clientes fazem login de novo todo dia.
O que é bom
- Funciona com clientes hospedados via OAuth 2.0 e PKCE
- Busca de dispositivos por nome entre interruptores e termostatos
- Repete comandos para dispositivos que ficam offline
- Código curto e legível, com correções de segurança no histórico
O que não é
- Um único segredo de cliente compartilhado controla todos os dispositivos
- Sem modo somente leitura, escopos ou limites por dispositivo
- Só nuvem; falha quando o eWeLink ou a internet caem
- Ainda sem licença, releases, testes ou outros usuários
Ideal para
Desenvolvedores com dispositivos Sonoff no eWeLink que querem um conector MCP remoto pequeno e legível para adaptar ao próprio uso.
Alternativas ao Sonoff MCP Server
Sonoff MCP Server: perguntas frequentes
- Sonoff MCP Server vale a pena?
- Um projeto pessoal caprichado que de fato aciona dispositivos Sonoff a partir do Claude, mas uma única senha compartilhada, nenhum modo somente leitura e nenhuma licença fazem dele um ponto de partida, e não algo para instalar como está. Damos nota 2.9 de 5.
- Quanto custa Sonoff MCP Server?
- Gratuito para rodar; o código não tem arquivo de licença. O nível de desenvolvedor pessoal do eWeLink é gratuito, com chamadas de API limitadas.
- Quais são as desvantagens de Sonoff MCP Server?
- Um único segredo de cliente compartilhado controla todos os dispositivos; sem modo somente leitura, escopos ou limites por dispositivo; só nuvem; falha quando o eWeLink ou a internet caem; ainda sem licença, releases, testes ou outros usuários.
- Para quem Sonoff MCP Server é indicado?
- Desenvolvedores com dispositivos Sonoff no eWeLink que querem um conector MCP remoto pequeno e legível para adaptar ao próprio uso.
- Quanto custa Sonoff MCP Server para uma equipe ou em produção?
- Gratuito, fora a hospedagem. O nível de desenvolvedor pessoal do eWeLink é gratuito, mas só com OAuth, com número limitado de chamadas de API e sem garantia de estabilidade; uso comercial exige o nível empresarial pago do eWeLink, com preço sob consulta.
- Sonoff MCP Server é seguro para dados da empresa?
- Guarda um segredo de app eWeLink, os tokens OAuth da conta e os próprios tokens MCP num volume Docker (arquivos de token gravados com 0600). Nomes, estados e leituras dos dispositivos passam pela nuvem do eWeLink e vão para o provedor de IA. Quem tiver o segredo de cliente MCP ou a MCP_API_KEY pode acionar todos os dispositivos da conta.
- Quais são as melhores alternativas ao Sonoff MCP Server?
- As alternativas mais próximas que analisamos são Home Assistant MCP Server, HA-MCP e Aqara MCP Server.
Respostas verificadas em 16 de nov. de 2026.