stackchan-mcpとは?
GitHubユーザーkisaragi-mochiによるstackchan-mcpは、M5Stack公式のStackChanキット(M5Stack CoreS3をベースにした2025年のKickstarter版)をMCPクライアントの身体に変えます。キットの出荷時ファームウェアをxiaozhi-esp32のビルドに置き換え、片側ではstdioのMCPサーバー、もう片側ではロボット向けのWebSocketサーバーとして働くPythonのゲートウェイを加えます。READMEには30のツールが並びます。首の2つのサーボによる頭の動き、320×240カメラでの撮影、タッチセンサーの読み取り、アバターの表情、口とまばたき、台座の12個のLED、発話、聞き取り、ビートに合わせる音楽モードです。
ゲートウェイはPyPIでstackchan-mcpとして公開され、ライセンスはMITです。ファームウェアはGPL-3.0のサーボライブラリをリンクするため、ファームウェアのビルドは実質的にGPL-3.0です。リポジトリのスターは約184で、2026年10月23日にゲートウェイv0.20.0とfirmware-v1.18.0を公開し、2026年11月にもコミットがありました。
stackchan-mcpのインストール方法
uv tool install stackchan-mcpstackchan-mcpは使う価値があるか?
ここでの物理的なリスクは小さいものの、プロジェクトはそれでも真剣に扱っています。動く部品は首の2つのSCS0009サーボだけです。ゲートウェイはヨー-90から90、ピッチ5から85度というM5Stackの推奨範囲の外へのmove_head呼び出しを拒み、ファームウェアはサーボへ書き込むたびにピッチを0から88に制限します。ゲートウェイを迂回した呼び出しでも、実機で確かめた限界を超えて頭を動かすことはできません。姿勢追従モードには角速度の制限があり、指令は毎秒20回までです。エージェントが操作するそれ以外のものは、画面、LED、スピーカー、マイクです。
気にすべきなのは最後の2つです。listenはロボットのマイクで録音して文字起こしし、既定では手元のマシンのfaster-whisper、選べばOpenAIのAPIを使います。take_photoはカメラの画像をモデル提供元に送ります。upgrade_firmwareツールはWi-Fi経由でロボットを書き換えられますが、ゲートウェイは先にファイルが有効なSHA-256を持つStackChanのイメージかを確かめ、デバイス側は元に戻すための領域を残します。
注意点:ゲートウェイのロボット向けの側は0.0.0.0で待ち受け、WebSocketにポート8765、写真のアップロードとファームウェアの配布に8766を使います。STACKCHAN_TOKENを設定していないと警告をログに出し、どのクライアントも受け入れます。最初に使う前に、ゲートウェイとロボットの両方にトークンを設定してください。シミュレーターはなく、試すには実機のキットを使いますが、多少のことでは壊れません。セットアップでは、USB経由でesptoolを使って書き込み、ロボットのキャプティブポータルでWi-Fiを設定し、発話のためにVOICEVOXを別のサービスとして動かします。
結論:キットを持っている人にとって、これは私たちが読んだ中で最も充実したMCPの道筋で、実機で確かめた修正を珍しいほど細かく記録した変更履歴もあります。身体を持つエージェントを探る愛好家や研究者に向いており、共有ネットワーク上で無人の機器が並ぶ教室には向きません。
真価を発揮する場面
音声中心のアシスタントを試作する開発者
コーディングエージェントに、状況を声で知らせ、話しかけると顔を上げる机上の存在を与えたい
音声がマシンの外に出ないよう、ローカルのVOICEVOXとfaster-whisperでゲートウェイを動かし、長い処理が終わったらエージェントにsayとset_avatarを呼ばせます。ソフトウェアは無料で、費用はモデルのトークンです。
身体を持つエージェントを研究するHCI研究者
エージェントが触れられたこと、音、見たものに反応するセッションを行いたい
頭のタッチセンサーを有効にし、stackchan/eventの通知を記録し、take_photoとlistenを組み合わせます。参加者とのセッションではSTACKCHAN_TOKENを設定し、ロボットを隔離したネットワークに置きます。
音楽セッションを配信するメイカー
部屋の音に合わせてロボットにうなずかせ、LEDを光らせたい
動きの強さと色を指定してbeat_mode_startを始めます。ゲートウェイがマイクからBPMを推定し、モデルを介さずに頭の揺れと台座の12個のLEDを動かします。
導入前に確認すること
- 導入
- 最新のファームウェアのリリースからmerged-binary.binをUSB経由でesptool.pyで書き込み、キャプティブポータルでWi-Fiにつなぎ、uv tool install stackchan-mcpでゲートウェイを入れ、両側にSTACKCHAN_TOKENを設定してから、クライアントにstackchan-mcpをstdioサーバーとして追加します。発話にはtts extraとVOICEVOXのサービスが必要です。
- 連携
- M5Stack StackChanキット(CoreS3、SCS0009サーボ、GC0308カメラ)。既定はVOICEVOXで、Irodori、ElevenLabs、Fish AudioのTTSも選べます。文字起こしはfaster-whisperまたはOpenAI。mDNSでの検出。LAN外での利用には任意でTailscale FunnelかCloudflareのリレー。
- データとプライバシー
- 写真と文字起こしはクライアントを通じてモデル提供元に送られます。OpenAIのエンジンを選ばない限り音声はローカルで文字起こしされます。ゲートウェイはロボット向けに0.0.0.0:8765と8766で待ち受け、STACKCHAN_TOKENがなければどのクライアントも受け入れます。任意のHTTPのMCPエンドポイントの既定は127.0.0.1です。
- 大規模利用時のコスト
- ソフトウェアは無料です。クラウドのTTSやOpenAIの文字起こしを選べば、それぞれの提供元が課金します。既定のローカルエンジンはハードウェア以外に費用がかかりません。
- 制限
- 対象はM5Stack公式キットだけで、自作のStackChanはピン配置が同じである必要があります。マルチキャストを遮断するネットワークではmDNSの検出が失敗します。未解決のissueとプルリクエストは約80件です。
良い点
- ゲートウェイとファームウェアの両方で頭の角度を制限
- 動き、カメラ、音声、表情、LEDにわたる30のツール
- 既定ではfaster-whisperでローカルに文字起こし
- イメージ確認とロールバック付きのWi-Fi経由ファームウェア更新
気になる点
- トークンを設定するまで0.0.0.0でどのクライアントも受け入れる
- キットの出荷時ファームウェアを置き換える
- 設計上マイクとカメラにアクセスする
- 対象はM5Stack公式キットだけ
おすすめの人
顔と声とカメラを持つエージ ェントを机の上に置きたい、M5Stack StackChanキットの持ち主。
stackchan-mcpの代替
stackchan-mcp:よくある質問
- stackchan-mcpは使う価値があるか?
- 机の上のエージェントに小さな身体を与える丁寧に作られた方法で、サーボには本物の制限がありますが、ネットワークの既定値は電源を入れる前に締めておくべきです。 評価は5点満点中3.8点です。
- stackchan-mcpの料金は?
- 無料のオープンソースです。ゲートウェイはMIT、ファームウェアのビルドは実質的にGPL-3.0です。M5StackのStackChanキットが必要です。
- stackchan-mcpの欠点は?
- トークンを設定するまで0.0.0.0でどのクライアントも受け入れる; キットの出荷時ファームウェアを置き換える; 設計上マイクとカメラにアクセスする; 対象はM5Stack公式キットだけ.
- stackchan-mcpは誰に向いているか?
- 顔と声とカメラを持つエージェントを机の上に置きたい、M5Stack StackChanキットの持ち主。
- チームや本番環境でstackchan-mcpを使うと費用はいくらか?
- ソフトウェアは無料です。クラウドのTTSやOpenAIの文字起こしを選べば、それぞれの提供元が課金します。既定のローカルエンジンはハードウェア以外に費用がかかりません。
- stackchan-mcpは企業データを扱っても安全か?
- 写真と文字起こしはクライアントを通じてモデル提供元に送られます。OpenAIのエンジンを選ばない限り音声はローカルで文字起こしされます。ゲートウェイはロボット向けに0.0.0.0:8765と8766で待ち受け、STACKCHAN_TOKENがなければどのクライアントも受け入れます。任意のHTTPのMCPエンドポイントの既定は127.0.0.1です。
- stackchan-mcpの代わりになるものは?
- 当サイトでレビューした中で最も近い代替はROS MCP Server 、 WLKATA MT4 control stackです。
回答確認日:2026年11月16日