Qu’est-ce que stackchan-mcp ?
stackchan-mcp, de l'utilisateur GitHub kisaragi-mochi, fait du kit officiel StackChan de M5Stack (la version Kickstarter de 2025, construite autour d'un M5Stack CoreS3) un corps pour un client MCP. Il remplace le firmware d'usine du kit par une version de xiaozhi-esp32 et ajoute une passerelle Python qui est, d'un côté, un serveur MCP en stdio et, de l'autre, un serveur WebSocket pour le robot. Le README liste 30 outils : mouvements de tête sur deux servos du cou, photos avec la caméra 320×240, lecture du capteur tactile, visages de l'avatar, bouche et clignement, les 12 LED du socle, synthèse vocale, écoute et un mode musical qui suit le rythme.
La passerelle est sur PyPI sous le nom stackchan-mcp et sous licence MIT ; le firmware intègre une bibliothèque de servos sous GPL-3.0, si bien que le firmware compilé est de fait sous GPL-3.0. Le dépôt compte environ 184 étoiles, a publié la passerelle v0.20.0 et firmware-v1.18.0 le 23 octobre 2026 et a reçu des commits en novembre 2026.
Installer stackchan-mcp
uv tool install stackchan-mcpstackchan-mcp vaut-il le coup ?
Les enjeux physiques sont faibles ici, et le projet les prend pourtant au sérieux. Les seules pièces mobiles sont deux servos SCS0009 du cou. La passerelle refuse les appels move_head hors d'un lacet de -90 à 90 et d'un tangage de 5 à 85 degrés, la plage recommandée par M5Stack, et le firmware borne le tangage entre 0 et 88 à chaque écriture vers le servo, de sorte qu'un appel qui contourne la passerelle ne peut toujours pas pousser la tête au-delà de la limite validée sur le vrai matériel. Le mode de suivi de pose ajoute une limite de vitesse angulaire et plafonne les commandes à 20 par seconde. Tout le reste de ce que contrôle l'agent, c'est un écran, des LED, un haut-parleur et un micro.
Ces deux derniers comptent davantage. listen enregistre avec le micro du robot et transcrit, par défaut avec faster-whisper sur votre propre machine, en option avec l'API d'OpenAI ; take_photo envoie l'image de la caméra à votre fournisseur de modèle. L'outil upgrade_firmware peut reflasher le robot par Wi-Fi, mais la passerelle vérifie d'abord que le fichier est une image StackChan avec un SHA-256 valide, et l'appareil garde un emplacement de retour arrière.
Le hic : le côté de la passerelle tourné vers le robot écoute sur 0.0.0.0, port 8765 pour le WebSocket et 8766 pour l'envoi des photos et le téléchargement du firmware, et si STACKCHAN_TOKEN n'est pas défini, il journalise un avertissement et accepte n'importe quel client. Définissez le jeton sur la passerelle et sur le robot avant la première utilisation. Il n'y a pas de simulateur ; tester veut dire utiliser le vrai kit, qui pardonne beaucoup. L'installation passe par un flashage avec esptool en USB, la configuration du Wi-Fi via le portail captif du robot et, pour la voix, un service VOICEVOX à part.
Notre avis : pour qui possède le kit, c'est la voie MCP la plus complète que nous ayons lue, avec un changelog qui consigne des corrections validées sur le matériel avec un rare degré de détail. Elle convient à un amateur ou à un chercheur qui explore les agents incarnés, pas à une salle de classe pleine d'appareils sans surveillance sur un réseau partagé.
Là où il fait la différence
Un développeur qui construit un prototype d'assistant vocal
Donner à un agent de code une présence sur le bureau qui annonce l'état à voix haute et lève la tête quand on lui parle
Faites tourner la passerelle avec VOICEVOX et faster-whisper en local pour que l'audio reste sur la machine, et laissez l'agent appeler say et set_avatar à la fin des longues tâches. Le logiciel ne coûte rien ; la facture, ce sont les tokens du modèle.
Une chercheuse en IHM qui étudie les agents incarnés
Mener des séances où un agent réagit au toucher, au son et à ce qu'il voit
Activez le capteur tactile de la tête, journalisez les notifications stackchan/event et associez take_photo à listen. Définissez STACKCHAN_TOKEN et gardez le robot sur un réseau isolé pendant les séances avec participants.
Un maker qui diffuse des sessions musicales
Faire hocher la tête du robot et clignoter ses LED en rythme avec la pièce
Lancez beat_mode_start avec une intensité de mouvement et une couleur ; la passerelle estime les BPM à partir du micro et pilote le balancement de la tête et les 12 LED du socle sans le modèle dans la boucle.
Avant de vous engager
- Mise en route
- Flashez merged-binary.bin de la dernière version du firmware avec esptool.py en USB, connectez le Wi-Fi via le portail captif, installez la passerelle avec uv tool install stackchan-mcp, définissez STACKCHAN_TOKEN des deux côtés, puis ajoutez stackchan-mcp à votre client comme serveur stdio. La voix demande l'extra tts et un service VOICEVOX.
- Intégrations
- Kit StackChan de M5Stack (CoreS3, servos SCS0009, caméra GC0308) ; VOICEVOX par défaut, avec en option la synthèse vocale Irodori, ElevenLabs et Fish Audio ; faster-whisper ou OpenAI pour la transcription ; découverte mDNS ; Tailscale Funnel ou un relais Cloudflare en option pour un usage hors du réseau local.
- Données et confidentialité
- Les photos et transcriptions partent chez votre fournisseur de modèle via le client ; l'audio est transcrit en local sauf si vous choisissez le moteur OpenAI. La passerelle écoute sur 0.0.0.0:8765 et 8766 pour le robot et accepte tout client sans STACKCHAN_TOKEN ; son point d'accès MCP HTTP optionnel utilise 127.0.0.1 par défaut.
- Coût à grande échelle
- Logiciel gratuit. La synthèse vocale dans le cloud ou la transcription OpenAI sont facturées par ces fournisseurs si vous les choisissez ; les moteurs locaux par défaut ne coûtent rien au-delà du matériel.
- Limites
- Ne vise que le kit officiel de M5Stack ; les StackChan faits maison doivent avoir le même brochage. La découverte mDNS échoue sur les réseaux qui bloquent le multicast. Environ 80 tickets et pull requests ouverts.
Les points forts
- La passerelle et le firmware bornent tous deux les angles de la tête
- 30 outils pour le mouvement, la caméra, l'audio, le visage et les LED
- Transcription locale par défaut avec faster-whisper
- Mises à jour du firmware par Wi-Fi avec vérification d'image et retour arrière
Les points faibles
- Accepte tout client sur 0.0.0.0 tant qu'aucun jeton n'est défini
- Remplace le firmware d'usine du kit
- Accès au micro et à la caméra par conception
- Ne vise que le kit officiel de M5Stack
Idéal pour
Propriétaires du kit StackChan de M5Stack qui veulent un agent doté d'un visage, d'une voix et d'une caméra sur leur bureau.
Alternatives à stackchan-mcp
stackchan-mcp : questions fréquentes
- stackchan-mcp vaut-il le coup ?
- Une façon soigneusement conçue de donner à un agent une petite présence physique sur votre bureau, avec de vraies limites sur les servos et un réglage réseau par défaut à durcir avant de le brancher. Nous lui donnons 3.8 sur 5.
- Combien coûte stackchan-mcp ?
- Gratuit et open source : la passerelle est sous MIT, le firmware compilé de fait sous GPL-3.0. Il vous faut le kit StackChan de M5Stack.
- Quels sont les inconvénients de stackchan-mcp ?
- Accepte tout client sur 0.0.0.0 tant qu'aucun jeton n'est défini; remplace le firmware d'usine du kit; accès au micro et à la caméra par conception; ne vise que le kit officiel de M5Stack.
- À qui s’adresse stackchan-mcp ?
- Propriétaires du kit StackChan de M5Stack qui veulent un agent doté d'un visage, d'une voix et d'une caméra sur leur bureau.
- Combien coûte stackchan-mcp pour une équipe ou en production ?
- Logiciel gratuit. La synthèse vocale dans le cloud ou la transcription OpenAI sont facturées par ces fournisseurs si vous les choisissez ; les moteurs locaux par défaut ne coûtent rien au-delà du matériel.
- stackchan-mcp est-il sûr pour les données de l’entreprise ?
- Les photos et transcriptions partent chez votre fournisseur de modèle via le client ; l'audio est transcrit en local sauf si vous choisissez le moteur OpenAI. La passerelle écoute sur 0.0.0.0:8765 et 8766 pour le robot et accepte tout client sans STACKCHAN_TOKEN ; son point d'accès MCP HTTP optionnel utilise 127.0.0.1 par défaut.
- Quelles sont les meilleures alternatives à stackchan-mcp ?
- Les alternatives les plus proches que nous avons testées sont ROS MCP Server et WLKATA MT4 control stack.
Réponses vérifiées le 16 nov. 2026.