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](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.
---
# 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](https://github.com/toio/toio.py)
- [uv](https://docs.astral.sh/uv/)
- [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) 1.7.1以上
### ステップ1. uvのインストール
`uv`のGetting startedに従って`uv`インストールしてください。
### ステップ2. toio-mcpレポジトリのクローン
```bash
git clone https://github.com/comoc/toio-mcp.git
cd toio-mcp
```
### ステップ3. 依存関係のインストール
```bash
uv sync
```
## 使用方法
### Claude Desktopで使う
Claude Desktop の設定 → 開発者 → 設定を編集 から `claude_desktop_config.json` を開き、以下を追加します:
```json
{
"mcpServers": {
"toio-mcp": {
"command": "uv",
"args": [
"--directory",
"<toio-mcpディレクトリへのパス>",
"run",
"server.py"
]
}
}
}
```
設定ファイルの場所:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
編集後にClaude Desktopを再起動すると、ツール一覧に toio-mcp のツールが表示されます。
### Claude Codeで使う
`claude mcp add` コマンドでサーバーを登録します:
```bash
claude mcp add toio-mcp -- uv --directory <toio-mcpディレクトリへのパス> run server.py
```
全プロジェクトで使いたい場合は `--scope user` を付け、現在のプロジェクトだけで使う場合はフラグなしで実行します。`claude mcp list` で登録確認後、Claude Code セッションからツールを呼び出せます。
### ClineやRoo Codeで使う
MCPの設定ファイルに以下の設定を追加します:
```json
{
"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ファイルを参照してください。
Connection Info
You Might Also Like
everything-claude-code
Complete Claude Code configuration collection - agents, skills, hooks,...
markitdown
MarkItDown-MCP is a lightweight server for converting URIs to Markdown.
firecrawl
Firecrawl MCP Server enables web scraping, crawling, and content extraction.
cc-switch
All-in-One Assistant for Claude Code, Codex & Gemini CLI across platforms.
servers
Model Context Protocol Servers
servers
Model Context Protocol Servers