What is Toio Mcp

toio-mcp is a Model Context Protocol (MCP) server designed for controlling toio Core Cubes using the MCP protocol.

Use cases

Use cases include programming educational robots, creating interactive art installations, and developing games that utilize toio Core Cubes for enhanced user interaction.

How to use

To use toio-mcp, install the required dependencies, clone the repository, and configure your MCP settings file to include the toio-mcp server. You can then utilize various tools to scan, connect, and control toio Core Cubes.

Key features

Key features include scanning and connecting to toio Core Cubes, controlling motors and LED indicators, retrieving position information, playing sounds, checking button states, battery levels, and sensor data.

Where to use

toio-mcp can be used in educational settings, robotics projects, and interactive installations where control of toio Core Cubes is required.

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 higher

Step 1. Install uv

Follow the Getting started guide for uv to install it.

Step 2. Clone the toio-mcp repository

git clone https://github.com/comoc/toio-mcp.git
cd toio-mcp

Step 3. Install dependencies

uv sync

Usage

Usage with Cline or Roo Code

Add the following configuration to your MCP settings file:

{
  "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.

---

toio-mcp (日本語)

toio-mcp は、toio Core Cube 用の Model Context Protocol (MCP) サーバーです。MCPプロトコルを通じてtoio Core Cubeを制御するためのツールセットを提供します。

特徴

• toio Core Cubeのスキャンと接続
• モーター制御
• LED制御（繰り返しパターンや消灯を含む）
• 位置情報の取得
• サウンド再生（効果音やMIDI音）
• ボタン状態の取得
• バッテリー残量の取得
• センサー情報の取得（モーション検出、姿勢角度、磁気センサー）

インストール

必要条件

• Python 3.11以上
• toio.py
• uv
• MCP Python SDK 1.7.1以上

ステップ1. uvのインストール

uvのGetting startedに従ってuvインストールしてください。

ステップ2. toio-mcpレポジトリのクローン

git clone https://github.com/comoc/toio-mcp.git
cd toio-mcp

ステップ3. 依存関係のインストール

uv sync

使用方法

ClineやRoo Codeでの使用

MCPの設定ファイルに以下の設定を追加します：

{
  "mcpServers": {
    "toio-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<toio-mcpディレクトリへのパス>",
        "run",
        "server.py"
      ],
      "alwaysAllow": [
        "add"
      ],
      "disabled": false
    }
  }
}

利用可能なツール

スキャナーツール

• scan_cubes: toio Core Cubeをスキャン
• connect_cube: toio Core Cubeに接続
• disconnect_cube: toio Core Cubeから切断
• get_connected_cubes: 接続されているCubeのリストを取得

モーターツール

• motor_control: toio Core Cubeのモーターを制御
• motor_stop: toio Core Cubeのモーターを停止

LEDツール

• set_indicator: toio Core CubeのLEDの色を設定
• set_repeated_indicator: 繰り返しLEDインジケーターパターンを設定
• turn_off_indicator: LEDインジケーターを消灯

位置情報ツール

• get_position: toio Core Cubeの位置情報を取得

サウンドツール

• play_sound_effect: 効果音を再生
• play_midi: MIDI音を再生
• stop_sound: サウンド再生を停止

ボタンツール

• get_button_state: ボタンの状態を取得

バッテリーツール

• get_battery_level: バッテリー残量を取得

センサーツール

• get_motion_detection: モーション検出情報を取得
• get_posture_angle: 姿勢角度情報を取得
• get_magnetic_sensor: 磁気センサー情報を取得

ライセンス

このプロジェクトはMITライセンスの下で提供されています - 詳細はLICENSEファイルを参照してください。