O que é stackchan-mcp?
O stackchan-mcp, do usuário do GitHub kisaragi-mochi, transforma o kit oficial StackChan da M5Stack (a versão do Kickstarter de 2025, montada sobre um M5Stack CoreS3) em um corpo para um cliente MCP. Ele substitui o firmware de fábrica do kit por um build do xiaozhi-esp32 e acrescenta um gateway em Python que, de um lado, é um servidor MCP via stdio e, do outro, um servidor WebSocket para o robô. O README lista 30 ferramentas: movimento da cabeça com dois servos do pescoço, fotos com a câmera de 320×240, leitura do sensor de toque, rostos do avatar, boca e piscada, os 12 LEDs da base, fala, escuta e um modo musical que acompanha a batida.
O gateway está no PyPI como stackchan-mcp e tem licença MIT; o firmware inclui uma biblioteca de servos GPL-3.0, então o build do firmware é, na prática, GPL-3.0. O repositório tem cerca de 184 estrelas, lançou o gateway v0.20.0 e o firmware-v1.18.0 em 23 de outubro de 2026 e teve commits em novembro de 2026.
Como instalar stackchan-mcp
uv tool install stackchan-mcpstackchan-mcp vale a pena?
O risco físico aqui é pequeno, e mesmo assim o projeto o leva a sério. As únicas peças móveis são dois servos SCS0009 do pescoço. O gateway rejeita chamadas a move_head fora de yaw de -90 a 90 e pitch de 5 a 85 graus, a faixa recomendada pela M5Stack, e o firmware limita o pitch a 0 a 88 em cada escrita no servo, de modo que uma chamada que pule o gateway ainda não consegue levar a cabeça além do limite validado em hardware real. O modo de seguir pose acrescenta um limite de velocidade angular e no máximo 20 comandos por segundo. Todo o resto que o agente controla é uma tela, LEDs, um alto-falante e um microfone.
Esses dois últimos pesam mais. listen grava pelo microfone do robô e transcreve, por padrão com faster-whisper na sua própria máquina e, opcionalmente, com a API da OpenAI; take_photo envia a imagem da câmera ao seu provedor de modelo. A ferramenta upgrade_firmware pode regravar o robô por Wi-Fi, mas o gateway verifica antes se o arquivo é uma imagem do StackChan com SHA-256 válido, e o aparelho mantém uma partição para reverter.
O porém: o lado do gateway voltado ao robô escuta em 0.0.0.0, porta 8765 para o WebSocket e 8766 para envio de fotos e download de firmware, e se STACKCHAN_TOKEN não estiver definido ele registra um aviso e aceita qualquer cliente. Defina o token no gateway e no robô antes do primeiro uso. Não há simulador; testar significa usar o kit real, que é tolerante. A instalação envolve gravar com esptool via USB, configurar o Wi-Fi pelo portal cativo do robô e, para a fala, rodar o VOICEVOX como serviço separado.
Nossa opinião: para quem tem o kit, é o caminho MCP mais completo que já lemos, com um changelog que registra correções validadas em hardware com detalhe incomum. Serve a um hobbista ou pesquisador explorando agentes com corpo, não a uma sala de aula cheia de aparelhos sem supervisão numa rede compartilhada.
Onde ele se destaca
Um desenvolvedor criando o protótipo de um assistente por voz
Dar a um agente de programação uma presença na mesa que fala atualizações de status e olha para cima quando alguém fala com ele
Rode o gateway com VOICEVOX e faster-whisper locais para que o áudio fique na máquina, e deixe o agente chamar say e set_avatar quando tarefas longas terminarem. O software não custa nada; a conta são os tokens do modelo.
Uma pesquisadora de IHC que estuda agentes com corpo
Fazer sessões em que um agente reage ao toque, ao som e ao que vê
Ative o sensor de toque da cabeça, registre as notificações stackchan/event e combine take_photo com listen. Defina STACKCHAN_TOKEN e mantenha o robô numa rede isolada durante as sessões com participantes.
Um maker que transmite sessões de música
Fazer o robô balançar a cabeça e piscar os LEDs no ritmo do ambiente
Inicie beat_mode_start com uma intensidade de movimento e uma cor; o gateway estima o BPM pelo microfone e comanda o balanço da cabeça e os 12 LEDs da base sem o modelo no circuito.
Antes de decidir
- Configuração
- Grave merged-binary.bin da versão mais recente do firmware com esptool.py via USB, conecte o Wi-Fi pelo portal cativo, instale o gateway com uv tool install stackchan-mcp, defina STACKCHAN_TOKEN dos dois lados e adicione stackchan-mcp ao seu cliente como servidor stdio. A fala exige o extra tts e um serviço VOICEVOX.
- Integrações
- Kit StackChan da M5Stack (CoreS3, servos SCS0009, câmera GC0308); VOICEVOX por padrão, com opções de TTS Irodori, ElevenLabs e Fish Audio; faster-whisper ou OpenAI para transcrição; descoberta por mDNS; Tailscale Funnel ou um relay da Cloudflare opcionais para uso fora da rede local.
- Dados e privacidade
- Fotos e transcrições vão para o seu provedor de modelo pelo cliente; o áudio é transcrito localmente, a menos que você escolha o motor da OpenAI. O gateway escuta em 0.0.0.0:8765 e 8766 para o robô e aceita qualquer cliente sem STACKCHAN_TOKEN; seu endpoint MCP HTTP opcional usa 127.0.0.1 por padrão.
- Custo em escala
- Software gratuito. TTS na nuvem ou transcrição da OpenAI são cobrados por esses provedores se você os escolher; os motores locais padrão não custam nada além do hardware.
- Limites
- Só mira o kit oficial da M5Stack; StackChans montados em casa precisam dos mesmos pinos. A descoberta por mDNS falha em redes que bloqueiam multicast. Cerca de 80 issues e pull requests abertos.
O que é bom
- Gateway e firmware limitam os ângulos da cabeça
- 30 ferramentas de movimento, câmera, áudio, rosto e LEDs
- Transcrição local por padrão com faster-whisper
- Atualização de firmware por Wi-Fi com checagem da imagem e reversão
O que não é
- Aceita qualquer cliente em 0.0.0.0 até você definir um token
- Substitui o firmware de fábrica do kit
- Acesso a microfone e câmera faz parte do projeto
- Só mira o kit oficial da M5Stack
Ideal para
Donos do kit StackChan da M5Stack que querem um agente com rosto, voz e câmera na mesa.
Alternativas ao stackchan-mcp
stackchan-mcp: perguntas frequentes
- stackchan-mcp vale a pena?
- Um jeito cuidadosamente projetado de dar a um agente uma pequena presença física na sua mesa, com limites reais nos servos e uma configuração de rede padrão que vale endurecer antes de ligar. Damos nota 3.8 de 5.
- Quanto custa stackchan-mcp?
- Gratuito e de código aberto: o gateway é MIT e o build do firmware, na prática, GPL-3.0. Você precisa do kit StackChan da M5Stack.
- Quais são as desvantagens de stackchan-mcp?
- Aceita qualquer cliente em 0.0.0.0 até você definir um token; substitui o firmware de fábrica do kit; acesso a microfone e câmera faz parte do projeto; só mira o kit oficial da M5Stack.
- Para quem stackchan-mcp é indicado?
- Donos do kit StackChan da M5Stack que querem um agente com rosto, voz e câmera na mesa.
- Quanto custa stackchan-mcp para uma equipe ou em produção?
- Software gratuito. TTS na nuvem ou transcrição da OpenAI são cobrados por esses provedores se você os escolher; os motores locais padrão não custam nada além do hardware.
- stackchan-mcp é seguro para dados da empresa?
- Fotos e transcrições vão para o seu provedor de modelo pelo cliente; o áudio é transcrito localmente, a menos que você escolha o motor da OpenAI. O gateway escuta em 0.0.0.0:8765 e 8766 para o robô e aceita qualquer cliente sem STACKCHAN_TOKEN; seu endpoint MCP HTTP opcional usa 127.0.0.1 por padrão.
- Quais são as melhores alternativas ao stackchan-mcp?
- As alternativas mais próximas que analisamos são ROS MCP Server e WLKATA MT4 control stack.
Respostas verificadas em 16 de nov. de 2026.