Bumi MCP — Noetix Bumi Humanoid Robot Control

📖 Installation Guide — quick start, manual setup, and troubleshooting

MCP server + REST bridge scaffold for the Noetix Bumi humanoid.

v0.2 adds /api/v1/* (health, telemetry, gated control) and mock bridge for CI/teleoperator prep. Full physical motion awaits EDU hardware + Noetix SDK topic mapping — see STATUS.md and INTEGRATION.md.

Bumi Product Info

Spec	Value
Manufacturer	Noetix Robotics (Beijing) — 北京松延动力科技集团股份有限公司
Website	noetixrobotics.com
Models	Lite · Air · Pro · Max · EDU-Air · EDU-Pro · EDU-Max
Price	From ~~10,000 CNY (~~€1,300 / ~$1,400) — "world's first 10k-CNY class humanoid"
Height/Weight	98cm / ~17kg
DOF	21 (6 per leg, 4 per arm, 1 lumbar, hands)
Compute (base)	6 TOPS
Compute (EDU)	NVIDIA Jetson Orin Nano Super / Orin NX
Sensors	RGB camera, IMU
Battery	48V 3.5Ah, 2-3h runtime, quick-swap
Connectivity	WiFi + Bluetooth, optional 4G/5G
Knee torque	70 N·m
Status	Shipping — thousands of orders placed (Dec 2025 news)

Features (from Noetix)

"Bumi Bumi" voice wake word + interaction
Object recognition (RGB camera)
One-click auto-standing on startup
Mobile app control + visual programming
Smart OTA updates
Autonomous lying down / standing up
Open Source SDK & development tools

Ordering

No direct e-commerce (no JD.com, Amazon, etc.). Noetix sells B2B through their sales team:

Contact	Details
Sales email	[email protected]
Hotline	400-096-9300 (Mon-Fri 10:00-19:00 Beijing)
WeChat	Scan QR code on noetixrobotics.com/en/contact-us
Inquiry form	noetixrobotics.com/en/contact-us?t=a
Partner inquiry	Become an agent

Pricing from ~~10,000 CNY (~~€1,300) for Lite model. Models: Lite · Air · Pro · Max · EDU-Air · EDU-Pro · EDU-Max. Price depends on model and quantity — contact sales for quote.

Architecture

PC (Goliath) ──Tailscale── Bumi (Jetson Orin)
                              │
                         rosbridge :9090
                              │
                         bumi-mcp :10774  (/api/v1)
                              │
                         Noetix SDK (walk, joints, estop)

Mock mode: BUMI_USE_MOCK_BRIDGE=1 — no hardware (default in .env.example)
Physical: BUMI_IP=<tailnet> + uv sync --extra robot
Yahboom copies in ros2/, minimal_mission_executor.py — reference only, not biped-safe

Files (physical path)

File	Purpose
`src/bumi_mcp/core/ros2_bridge.py`	roslibpy telemetry + gated walk/estop
`src/bumi_mcp/testing/mock_bridge.py`	CI / dev stand-in
`src/bumi_mcp/api_v1.py`	teleoperator-facing REST
`STATUS.md` / `INTEGRATION.md`	Readiness + bring-up

Legacy Yahboom ports (reference)

File	Origin	Purpose
`minimal_mission_executor.py`	yahboom-mcp	Holonomic missions — not for Bumi
`vision_bridge.py`	yahboom-mcp	COCO detection bridge
`scripts/deploy.sh`	yahboom-mcp	Deprecated Pi deploy
`ros2/bumi_mission_executor/`	boomy fork	Wheeled mission package

Quick Start

git clone https://github.com/sandraschi/bumi-mcp
cd bumi-mcp
just

This opens an interactive dashboard showing all available commands. Run just serve with .env from .env.example (mock bridge by default).

Copy-Item .env.example .env
just serve
Invoke-RestMethod http://127.0.0.1:10774/api/v1/health
just test
just ci

Physical bot

See INTEGRATION.md — BUMI_IP, uv sync --extra robot, telemetry first, then gated motion.

License

MIT

Bumi MCP

README