kisaragi-mochi/stackchan-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
키사라기-모치/스택찬-MCP는 [[T0]에서 가져온 MCP 서버 후보입니다.
개요
키사라기-모치/스택찬-MCP는 [[T0]에서 가져온 MCP 서버 후보입니다.
개요(AI 번역)
영어 | 日本語
스택찬-MCP
M5Stack 공식 StackChan*(2025 킥스타터 출하 키트)용 MCP(모델 컨텍스트 프로토콜) 브리지로, 어떤 LLM 클라이언트도 장치를 구동할 수 있습니다.
2021년 이시카와 신야가 시작한 스택-찬 프로젝트 커뮤니티에서 탄생했습니다. 이 저장소는 그 계보에서 발전한 M5Stack 공식 스택찬 키트를 대상으로 합니다.
어떤 MCP 클라이언트(Claude Code, Claude Desktop 등)에서든 머리 움직임, 카메라 캡처, 터치 센서 읽기, 아바타 표현 스위치 같은 StackChan 작업을 호출할 수 있습니다.
저장소 레이아웃
이 저장소는 모노레포입니다.
| 디렉토리 | 목차 |
|---|---|
firmware/ |
78/xiaozhi-esp32의 전체 git 서브트리. 커스텀 StackChan 보드는 firmware/main/boards/stackchan/에 위치해 있습니다. |
gateway/ |
파이썬 MCP 게이트웨이. stdio MCP 서버(LLM 측) + WebSocket MCP 클라이언트(ESP32 측) + HTTP 캡처 서버. |
docs/ |
architecture.md: 전체 부품 다이어그램, 도구명 매핑, 사진 흐름, 인증, 단계 로드맵. firmware-sync.md: 업스트림 xiaozhi-esp32 동기화 플레이북. remote-access.md: 비-LAN 사용을 위한 테일스케일 퍼널 설정. |
examples/ |
선택 사항, 유지 관리되지 않은 예시들. |
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
English | 日本語
stackchan-mcp
An MCP (Model Context Protocol) bridge for the M5Stack official StackChan (2025 Kickstarter shipping kit), letting any LLM client drive the device.
Born out of the stack-chan project community (originated by Shinya Ishikawa in 2021). This repository targets the M5Stack official StackChan kit that grew out of that lineage.
┌─────────────┐ stdio MCP ┌──────────────┐ WebSocket MCP ┌──────────────┐
│ MCP client │ ─────────────────▶ │ gateway │ ──────────────────▶ │ ESP32 (CoreS3│
│ (e.g.Claude)│ ◀───────────────── │ (Python) │ ◀────────────────── │ +StackChan) │
└─────────────┘ │ │ └──────────────┘
│ /capture │ ◀── HTTP POST (JPEG) ──┘
└──────────────┘
From any MCP client (Claude Code / Claude Desktop / others) you can call StackChan operations such as head movement, camera capture, touch sensor reads, and avatar expression switches.
Repository layout
This repository is a monorepo.
| Directory | Contents |
|---|---|
firmware/ |
Full git subtree of 78/xiaozhi-esp32. The custom StackChan board lives at firmware/main/boards/stackchan/. |
gateway/ |
Python MCP gateway. stdio MCP server (LLM side) + WebSocket MCP client (ESP32 side) + HTTP capture server. |
docs/ |
architecture.md: full component diagram, tool name mapping, photo flow, auth, phase roadmap. firmware-sync.md: upstream xiaozhi-esp32 sync playbook. remote-access.md: Tailscale Funnel setup for non-LAN use. |
examples/ |
Optional, unmaintained examples. cloudflare-relay/: Cloudflare Workers WebSocket relay for reaching the gateway from outside the local LAN. |
Target hardware
M5Stack official StackChan kit (Kickstarter 2025 shipping version). The firmware in this repository is meant to replace the kit’s factory firmware.
| Part | Spec |
|---|---|
| Body | M5Stack CoreS3 (ESP32-S3, 16MB Flash, 8MB PSRAM) |
| Neck servos | SCS0009 ×2 (yaw + pitch, serial bus, TX=GPIO6, RX=GPIO7) |
| Camera | GC0308 (DVP, 320×240) |
| Touch | FT6336 / Si12T |
| Display | ILI9342 (SPI, 320×240) |
A self-built stack-chan (following the original stack-chan project design) may also work as long as the pin assignments and I2C addresses match. Reports and PRs welcome.
Tools (callable by MCP clients via the gateway)
| Tool | Description | Status |
|---|
설치
docker run --rm --cpus=4 --ulimit nofile=65536:65536 \설정
{
"mcpServers": {
"stackchan-mcp": {
"type": "stdio",
"command": "stackchan-mcp",
"env": {
"STACKCHAN_TOKEN": "your-secret-token-here",
"VISION_HOST": "your.host.lan.ip"
}
}
}
}