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 Claude Desktop Open Claude Desktop's `claude_desktop_config.json` (Settings → Developer → Edit Config) and add: ```json { "mcpServers": { "toio-mcp": { "command": "uv", "args": [ "--directory", "<path to toio-mcp directory>", "run", "server.py" ] } } } ``` The config file lives at: - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%\Claude\claude_desktop_config.json` Restart Claude Desktop after editing. The toio-mcp tools should appear in the tool picker. ### Usage with Claude Code Register the server with the `claude mcp add` CLI: ```bash claude mcp add toio-mcp -- uv --directory <path to toio-mcp directory> run server.py ``` Use `--scope user` to make it available across all projects, or omit the flag to keep it project-local. Verify with `claude mcp list` and start using the tools from any Claude Code session. ### 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.