Robotics MCP

Robotics MCP Server

<p align="center"> <a href="https://github.com/casey/just"><img src="https://img.shields.io/badge/just-ready_to_go-7c5cfc?style=flat-square&logo=just&logoColor=white" alt="Just"></a> <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff"></a> <a href="https://python.org"><img src="https://img.shields.io/badge/Python-3.13+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python"></a> <a href="https://biomejs.dev"><img src="https://img.shields.io/badge/Linted_with-Biome-60a5fa?style=flat-square&logo=biome&logoColor=white" alt="Biome"></a> <a href="https://github.com/PrefectHQ/fastmcp"><img src="https://img.shields.io/badge/FastMCP-3.4.4+-7c5cfc?style=flat-square" alt="FastMCP"></a> </p>

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

Author: FlowEngineer sandraschi

One MCP server for physical robots (Dreame vacuums, Yahboom ROS, Elegoo, Nori A3), Gazebo, and virtual stacks (Unity, VRChat). FastMCP, stdio + HTTP. Optional watchfiles restarts for dev or unattended runs (not an SLA).

Doc	Contents
Technical README	Prerequisites, hardware, install, packaging, Cursor, config, composed MCPs, testing, troubleshooting
Usage and API	Tool examples, web UI, HTTP endpoints
Android Doctrine	Safety, legal, and operational standards for the android fleet
Setup Prerequisites	Unity, VRChat, peer MCP servers when you need the full stack
Crash protection (watchfiles)	Auto-restart and health checks
Autonomous Robotics Pipeline	11-stage CAD -> OpenUSD -> Isaac Lab (RSL-RL / GR00T N1.5 / Newton) -> Genie 4 World Model Dojo -> ROS 2 -> Active Inference (saschibot & Nori A3)
Gemini Robotics Distillations	18-part synthesis of CAD/USD pipelines, Isaac Lab RL, Genie 4 World Model Dojo, ros2_control, and Active Inference (FEP)
Hardware Reference	Subsystem histology (TELESCOPIC_LIFT, ROLLING_BASE, ARMS, GRIPPERS_HANDS, DOCK_STATION, HEAD_SENSORS_SCREEN)

Status: Industrial v1.4.1 (2026-04-14) | SOTA v1.4.1 Compliance | Benny Protocol Secured.

Quick Start

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

This opens an interactive dashboard showing all available commands. Run just bootstrap to install dependencies, then just serve or just dev to start.

Manual Setup

If you don't have just installed:

Install

uvx robotics-mcp

pip install robotics-mcp

Development clone: see Installation in the technical README.

Contributing

See CONTRIBUTING.md.

🛡️ Industrial Quality Stack

This project adheres to SOTA 14.1 industrial standards for high-fidelity agentic orchestration:

• Python (Core): Ruff for linting and formatting. Zero-tolerance for print statements in core handlers (T201).
• Webapp (UI): Biome for sub-millisecond linting. Strict noConsoleLog enforcement.
• Protocol Compliance: Hardened stdout/stderr isolation to ensure crash-resistant JSON-RPC communication.
• Automation: Justfile recipes for all fleet operations (just lint, just fix, just dev).
• Security: Automated audits via bandit and safety.

License

MIT see LICENSE.

Acknowledgments

FastMCP; ROS community; Unity3D, VRChat, World Labs Marble/Chisel; MCP ecosystem contributors.