toio-mcp
About
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.
Details
- Author
- comoc
- Downloads
- 280
- Categories
- Other
Jump to
- 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.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
toio-mcpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"toio-mcp": {
"toio-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}
}
}McpServers
{
"toio-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}toio-mcp
toio-mcp is a Model Context Protocol (MCP) server for toio Core Cube. It provides a set of tools to control toio Core Cubes via the MCP protocol.Features
- Scan and connect to toio Core Cubes - Control motors - Control LED indicators (including repeated patterns and turning off) - Get position information - Play sounds (sound effects and MIDI notes) - Get button state - Get battery level - Get sensor information (motion detection, posture angle, magnetic sensor)Installation
Requirements
- Python 3.11 or higher - toio.py - uv - MCP Python SDK 1.7.1 or higherStep 1. Install uv
Follow the Getting started guide for uv to install it.
Step 2. Clone the toio-mcp repository
``bash
git clone https://github.com/comoc/toio-mcp.git
cd toio-mcp
`
Step 3. Install dependencies
`bash
uv sync
`
Usage
Usage with Cline or Roo Code
Add the following configuration to your MCP settings file:
`json
{
"mcpServers": {
"toio-mcp": {
"command": "uv",
"args": [
"--directory",
"<path to toio-mcp directory>",
"run",
"server.py"
],
"alwaysAllow": [
"add"
],
"disabled": false
}
}
}
`
Available tools
Scanner tools
- scan_cubes: Scan for toio Core Cubes
- connect_cube: Connect to a toio Core Cube
- disconnect_cube: Disconnect from a toio Core Cube
- get_connected_cubes: Get a list of connected cubes
Motor tools
- motor_control: Control the motors of a toio Core Cube
- motor_stop: Stop the motors of a toio Core Cube
LED tools
- set_indicator: Set the LED color of a toio Core Cube
- set_repeated_indicator: Set repeated LED indicator patterns
- turn_off_indicator: Turn off LED indicators
Position tools
- get_position: Get the position of a toio Core Cube
Sound tools
- play_sound_effect: Play a sound effect
- play_midi: Play a MIDI note
- stop_sound: Stop sound playback
Button tools
- get_button_state: Get the button state
Battery tools
- get_battery_level: Get the battery level
Sensor tools
- get_motion_detection: Get motion detection information
- get_posture_angle: Get posture angle information
- get_magnetic_sensor`: Get magnetic sensor information
License
This project is licensed under the MIT License - see the LICENSE file for details. ---Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
