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 카메라로 사진 찍기, 터치 센서 읽기, 아바타 표정, 입과 깜빡임, 받침대의 LED 12개, 말하기, 듣기, 박자를 따르는 음악 모드입니다.
게이트웨이는 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, 쓸 만한 가치가 있습니까?
여기서 물리적 위험은 작지만 프로젝트는 그래도 진지하게 다룹니다. 움직이는 부품은 목의 SCS0009 서보 2개뿐입니다. 게이트웨이는 요 -90에서 90, 피치 5에서 85도라는 M5Stack 권장 범위를 벗어난 move_head 호출을 거부하고, 펌웨어는 서보에 쓸 때마다 피치를 0에서 88로 제한하므로 게이트웨이를 건너뛴 호출도 실제 하드웨어에서 확인한 한계 너머로 머리를 움직일 수 없습니다. 자세 추종 모드에는 각속도 제한이 더해지고 명령은 초당 20회로 제한됩니다. 에이전트가 다루는 나머지는 화면, LED, 스피커, 마이크입니다.
더 신경 써야 할 것은 마지막 두 가지입니다. 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을 추정해 모델 없이 머리 흔들기와 받침대의 LED 12개를 움직입니다.
도입 전 확인할 점
- 설정
- 최신 펌웨어 릴리스의 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 탐색이 실패합니다. 열린 이슈와 풀 리퀘스트는 약 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일.