About stack-chan/stack-chan
stack-chan/stack-chan is an MCP server published by stack-chan in the Developer Tools category: a JavaScript-driven M5Stack-embedded super-kawaii robot.
The repository has 1.8K stars and 238 forks, with the last commit 10 hours ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/stack-chan/stack-chanThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (7)
[Block editor](https://stack-chan.github.io/stack-chan/web/editor/)Create MODs with Blockly and run them in the simulator or on a device
Parameters not published.
[Firmware installer](https://stack-chan.github.io/stack-chan/web/flash/)Flash firmware to a supported M5Stack over USB
Parameters not published.
[MOD Gallery](https://stack-chan.github.io/stack-chan/web/mod-gallery/)Find, try, and install published MODs
Parameters not published.
[MediaPipe BLE tracking](https://stack-chan.github.io/stack-chan/web/mediapipe/)Send tracked face and hand movement over BLE
Parameters not published.
[Preferences](https://stack-chan.github.io/stack-chan/web/preference/)Change Wi-Fi and device preferences over BLE
Parameters not published.
[Shape face editor](https://stack-chan.github.io/stack-chan/web/face-editor/)Arrange eyes and a mouth to create a custom Face
Parameters not published.
[Simulator](https://stack-chan.github.io/stack-chan/web/simulator/)Run MODs with the WebAssembly firmware and a 3D model
Parameters not published.
Ask AI
Ask AI about stack-chan/stack-chan
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 7 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
1 check has not been run yet.
Releases
README
Stack-chan
Stack-chan is an open-source, JavaScript-driven, super-kawaii robot built with M5Stack.
This repository provides firmware with M5StackChan CoreS3 as its standard configuration, user applications called MODs, browser development tools, cases, and schematics.
- Video (with English subtitles): https://youtu.be/fZb_mF08xV0
- Official hashtag:
#stackchan|#ｽﾀｯｸﾁｬﾝ(JP)
Getting started
If this is your first Stack-chan, start with a preassembled M5StackChan and the browser tools.
1. Get an M5StackChan
The standard M5StackChan AI Desktop Robot (K151) package is enough to get started. The joystick remote controller is optional.
- Worldwide: M5Stack Official Store
- Japan: M5StackChan
- Japan: M5StackChan with joystick remote controller
2. Flash the firmware
Connect M5StackChan to a computer with a data-capable USB cable, then open the Web firmware installer in Chrome or Edge. Select "M5StackChan CoreS3" as the device. You do not need to install the Moddable SDK or ESP-IDF.
[!IMPORTANT] Flashing this repository's firmware replaces the factory firmware supplied by M5Stack. To restore it, follow the restore procedure in the M5Stack product documentation and use M5Burner.
3. Try a MOD
Find published MODs and mini apps in the MOD Gallery. Choose a MOD, then run it in the simulator or install it on a device. Block-based samples can be opened directly in the block editor and changed.
Browser tools
Use the Stack-chan browser tools to set up a device, change its preferences, and create MODs in a browser.
| Tool | Purpose |
|---|---|
| Firmware installer | Flash firmware to a supported M5Stack over USB |
| Preferences | Change Wi-Fi and device preferences over BLE |
| MOD Gallery | Find, try, and install published MODs |
| Block editor | Create MODs with Blockly and run them in the simulator or on a device |
| Shape face editor | Arrange eyes and a mouth to create a custom Face |
| Simulator | Run MODs with the WebAssembly firmware and a 3D model |
| MediaPipe BLE tracking | Send tracked face and hand movement over BLE |
Supported hardware
The distributed firmware supports M5Stack, M5Stack Core2, M5Stack CoreS3, and M5StackChan CoreS3. M5StackChan CoreS3 is the standard configuration and the target used for physical-device release validation.
Firmware for Stack-chan RT and Takao Core2 + SG90 can be built from source. See the firmware guide for target-specific commands and constraints.
To build the hardware yourself, see the case guide for parts and assembly instructions. See the schematics for board information.
Repository contents
- firmware: Host firmware, modules, MODs, and development scripts
- web: Firmware installer, preferences, editors, Gallery, and simulator
- case: Case models for 3D printing
- schematics: Schematics and board layouts
- docs: Roadmap, specifications, operations guides, and release notes
Development
- Firmware development
- MOD development
- Firmware API
- Contribution guide
- Latest release
- Development roadmap
Contributing
Feature requests, bug reports, and pull requests are welcome. Read the contribution guide, or open an issue.
To support the project financially, visit the GitHub Sponsors page.
License
The resources in this repository are distributed under the Apache License 2.0. See LICENSE.
BibTeX
@misc{stackchan,
author = {Shinya Ishikawa and the Stack-chan community},
title = {Stack-chan: A JavaScript-driven Super-kawaii Robot},
year = {2021},
howpublished = {\url{https://github.com/stack-chan/stack-chan}},
note = {Open-source hardware and software.},
}
README fetched from the repository 7 hours ago. The original is authoritative.