toio-mcp

# 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](https://github.com/toio/toio.py) - [uv](https://docs.astral.sh/uv/) - [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) 1.7.1 or higher ### Step 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.