Pular para o conteúdo
ReviewRamble

A newsletter semanal

IA, analisada, na sua caixa de entrada.

  • Novas análises de ferramentas, modelos, servidores MCP e repositórios, com o veredicto logo no início
  • Preços e notas reconferidos quando algo muda
  • Novos artigos de análise assim que são publicados

Modelos, agentes, servidores MCP e as ferramentas que realmente valem seu tempo.

Um e-mail por semana. Cancele pelo link em qualquer edição. Como usamos seu e-mail

stackchan-mcp

Firmware próprio e um gateway em Python que deixam um agente se mover, ver, ouvir e falar pelo robô de mesa StackChan, da M5Stack.

Análise de ReviewRamble editors · Atualizado

Guia de instalação Código aberto

Compartilhe esta página:XLinkedInFacebookRedditWhatsAppE-mail

Nossa nota

3.8/5

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.

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-mcp

stackchan-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.