toio-mcp

What is toio-mcp?

toio-mcp is a Model Context Protocol (MCP) server for the toio Core Cube. It provides a set of tools that allow AI assistants to scan, connect to, and control toio Core Cubes via the MCP protocol, enabling motor, LED, sound, position, and sensor operations.

How to use toio-mcp?

Install Python 3.11+ and uv, clone the repository, run uv sync to install dependencies. Then configure an MCP client (e.g., Cline or Roo Code) by adding a JSON entry with the command uv and arguments --directory <path> run server.py. Once configured, the server exposes tools for scanning, connecting, motor control, LED control, sound playback, position queries, button state, battery level, and sensor readings.

Key features of toio-mcp

• Scan and connect to toio Core Cubes.
• Control motor speed and direction.
• Set LED colors and repeated indicator patterns.
• Get real-time position information.
• Play sound effects and MIDI notes.
• Retrieve button, battery, and sensor data.

Use cases of toio-mcp

• Control toio Cube movements directly from a chat interface.
• Create interactive light shows using repeated LED patterns.
• Trigger sound effects or musical notes based on Cube actions.
• Develop educational robotics demonstrations with sensor feedback.
• Automate Cube behaviors in coding tutorials or game prototypes.

FAQ from toio-mcp

What are the system requirements for toio-mcp?

Python 3.11 or higher, the toio.py library, uv package manager, and MCP Python SDK 1.7.1 or later.

How do I use toio-mcp with Cline or Roo Code?

Add a JSON entry to your MCP settings file: set command