toio-mcp

Created By

comoc9 months ago

toio-mcp is a MCP server for toio™

Content

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
    }
  }
}