スタックちゃん AI連携プロジェクト

テーマ

スタックちゃん AI連携設計書 & ナレッジ集

M5Stack スタックちゃん × ローカル LLM × Claude Agent SDK

ナレッジを読む
通信プロトコル仕様
GitHub
🤖

全体アーキテクチャ

スタックちゃん本体（M5Stack CoreS3）↔ Mac Studio（ローカルLLM ＋ Claude Agent SDK）の二段構成。軽い応答はローカル、深い思考は Claude に委譲。

📚

電子工作の基礎

「電子工作はじめて」を前提に、CoreS3 とは何か・USB 接続で何が起きるか・PlatformIO のビルド書き込みの仕組みを噛み砕いて解説。

🛠

トラブル事典

開発で躓いたポイント（macOS の libexpat 問題、VarSpeedServo の ESP32 非互換、シリアルモニタの TTY 問題など）を症状→原因→対処の3点で記録。

🔌

通信プロトコル

WebSocket + MCP + mDNS による設計。音声バイナリ・状態同期・MCP ツール呼び出し・Claude Agent ストリーミングまでのスキーマを整理。

このドキュメントについて ​

スタックちゃん AI連携プロジェクトの設計書と、開発で詰まったポイントを後追いで理解するためのナレッジ集をまとめたサイト。

  • 📐 設計書: 全体アーキテクチャ、通信プロトコル、フェーズ計画
  • 🧠 ナレッジ: 電子工作の基礎、PlatformIO の使い方、シリアル通信の読み方
  • 🚨 トラブル事典: 詰まったら症状から引ける

読み始める順番（電子工作はじめての人） ​

  1. 01. ハードウェアの基礎 — スタックちゃんが何でできているか
  2. 02. PlatformIO セットアップ — ビルド・書き込みの仕組み
  3. 03. シリアルモニタ — リセットボタンと起動ログの読み方

開発者向けスタート ​

アーキテクチャ概要 ​

┌──────────────────────┐      WiFi / WSS + MCP      ┌──────────────────────────┐
│  スタックちゃん本体   │ ────────────────────────────▶│  Mac Studio              │
│  (M5Stack CoreS3)    │                              │  ├─ 管理画面 (Next.js)    │
│  ├─ 音声入出力        │ ◀──────────────────────────── │  ├─ MCP サーバー          │
│  ├─ Claude風ドット表情│  ストリーミング応答           │  ├─ ローカル LLM (軽思考) │
│  └─ サーボ・LED       │                              │  └─ Claude Agent SDK     │
└──────────────────────┘                              │       (深い思考)         │
                                                      └──────────────────────────┘

aieo-product / stack-chan project

© 2026 syn-group