Skip to main content
Glama
ARCL CYD Desktop MCP bridge

ARCL CYD Desktop MCP bridge

by manymids

ARCL CYD Desktop

English | 日本語

ESP32-2432S028 CYD 向けの小型デスクトップ環境です。タッチ操作に加え、USBシリアルとMCPから状態確認、アプリの起動、入力、ファイル転送を行えます。ESP-IDF上のネイティブシェルにMicroPythonを組み込み、microSD上のアプリを実行します。

主な機能

  • Home/Start、時計・カレンダー、Scripts、設定、テキストエディタ、画面キーボード

  • 無線モードの切替(OFF/Wi-Fi/Bluetooth。排他で、切替は再起動)

  • Bluetoothキーボード:ペアリング画面、JIS/US配列、エディタ・コンソール・アプリへのキー入力、接続中は画面キーボードを隠す

  • Scriptsから実行したスクリプトの print() 出力とエラーを画面に表示、Ctrl+Cで中断

  • NVSへのタッチ較正保存、FAT/FAT32のmicroSDマウント

  • MicroPythonアプリのインストール・起動・削除、Homeショートカット

  • USB JSON Linesによる状態取得・入力操作、stdio MCP bridge

  • UIツリー、診断、ログ、例外トレースバック、協調的なpause/step/resume

  • 2D描画、ゲーム用スプライト、JPEG表示、MJP1動画再生

  • Native App SDK、組込みレイキャストデモ neon3d、MJPプレイヤー mjpplayer

LCDは320×240です。通常のUI描画は最大320×16のタイルを転送し、全画面のフレームバッファを必要としない構成です。画面ミラーはUIツリーからPC側で再構成するPNGのため、LCD上のすべての描画を再現するものではありません。

本体はMITライセンスです。詳しくは末尾の「ライセンス」を参照してください。

Related MCP server: mcp-micropython-bridge

開発者向けドキュメント

対象環境

項目

内容

ボード

ESP32-2432S028 CYD(ILI9341版)だけ。下の「対応ハードウェア」を参照

PC側

Node.jsとnpm。ホスト側検証ではNode.js 22.17.0を使用

接続

USBシリアル、通常115200 baud、8N1

ストレージ

FAT/FAT32形式のmicroSD

キーボード(任意)

Bluetooth Classic(HID)のキーボード。BLE専用のキーボードとマウスは非対応

ファームウェア開発環境

WSL Ubuntu 24.04、ESP-IDF、MicroPython

対応ハードウェア

対応するのは、ILI9341の液晶と抵抗膜タッチ(XPT2046)を載せたESP32-2432S028(通称CYD、Cheap Yellow Display) だけです。ピン配置、液晶の初期化、向き(横長320×240、BGR)はファームウェアに固定しており、設定で切り替える仕組みはありません。

部品

仕様・接続

SoC

ESP32-D0WD-V3、Flash 4 MiB、PSRAMなし

液晶

ILI9341 2.8インチ 320×240、SPI2:SCK=14、MOSI=13、MISO=12、CS=15、DC=2、バックライト=21

タッチ

XPT2046(抵抗膜、ビットバング):CLK=25、MOSI=32、MISO=39、CS=33、IRQ=36

microSD

SCK=18、MOSI=23、MISO=19、CS=5(machine.SDCard(slot=2))

USBシリアル

CH340(VID 1a86/PID 7523)

次の基板は対応していません:液晶がST7789の版(USB端子が2つあるCYD2USBなど)、静電容量式タッチの版、画面サイズの違う派生品(ESP32-3248S035など)。書き込んでも表示が崩れる・色が反転する・タッチが効かない、といった状態になります。

初回起動:タッチ補正が保存されていない基板では、起動するとすぐに補正画面になります。3か所に順に表示される十字の中心をタップすると保存され、Homeが表示されます。やり直すときは Settings > SYSTEM > CALIBRATE(MCPでは cyd_touch_calibrate_start)です。補正はNVSに保存され、アプリ領域だけの書き込みでは消えません。

MicroPythonアプリは単一前景で実行します。「Sandbox」はセキュリティ上の隔離を意味しません。アプリはMicroPythonのファイル・ハードウェアAPIを利用できるため、信頼できるアプリを実行してください。

PC MCP bridge

リポジトリ直下で依存パッケージをインストールします。

npm ci
$env:CYD_DESKTOP_PORT = "COM6" # 実際の接続先に置き換える
npm start

ポートを指定しない場合はCH340(VID 1a86 / PID 7523)を自動検出します。複数のCH340機器がある場合はポートを明示してください。MCPクライアントからは、このフォルダを作業ディレクトリとして node bridge/index.mjs を起動します。通信方式はstdioで、ネットワーク待受けは行いません。

ツール名は ARCL 共通仕様(別プロジェクトの外部仕様。v0.5 を同梱)の命名規約に従い、共通 API の arcl_status と、CYD 固有の cyd_* に分かれます。主なツールは arcl_status、cyd_launch、cyd_home、cyd_tap、cyd_input_macro、cyd_key_press、cyd_type_text、cyd_ui_tree、cyd_settings_get/set、cyd_radio_status/set、cyd_bt_status/scan/connect/forget、cyd_logs、cyd_diagnostics、cyd_app_error、cyd_pause/step/resume、cyd_screen_mirror です。

  • arcl_status は machine: "cyd"、有効なレイヤ、現在の画面を返します。

  • CYD はエミュレータではなく実機です。シェル、ネイティブアプリ、動画、時計は実時間で動き続け、止められません。フレーム番号とステート保存はありません(arcl_status の frame は null、time_control は "none")。cyd_pause/step/run が止めるのは、前面の MicroPython アプリの cyd.update() だけです。

  • 公開するツールは能力レイヤで絞り込めます。node bridge/index.mjs --mcp-layers=L0,L1(または環境変数 CYD_MCP_LAYERS)。L0 は画面と入力(キー入力を含む)、L1 はアプリ・設定・ファイル、L2 はログと診断、L3 は SD・タッチ較正・無線モード・Bluetooth です。arcl_status と cyd_pause などの Control 系は常に公開されます。指定しなければ全レイヤを公開します。

全ツールの種別・レイヤ・引数は MCP ツール一覧 にあります。MCP のツール名とは別に、ファームウェアのシリアルプロトコルのコマンドは desktop_* のままです(下の JSON Lines の例)。

同じシリアルポートをMCP bridge、転送コマンド、書込みツールなどで同時に開かないでください。

microSDとアプリ

FAT/FAT32のmicroSDを電源投入前に挿入してください。起動時に machine.SDCard(slot=2)(SCK=18、MOSI=23、MISO=19、CS=5)で /sd にマウントします。マウント失敗時に自動フォーマットはしません。cyd_sd_status で状態を確認できます。カード交換後は再起動が必要です。

アプリは /sd/apps/<app-id>/ に配置します。次の2ファイルをPC側の apps/hello/ に作成すると、画像を使わない最小アプリを試せます。

manifest.json:

{
  "id": "hello",
  "title": "HELLO",
  "entry": "main.py",
  "version": "0.0.1"
}

main.py:

import cyd
import time

cyd.clear()
cyd.title("HELLO")
cyd.text(16, 60, "Hello, CYD!")

while cyd.update():
    time.sleep_ms(20)

bridgeを終了してポートを空けてから、ディレクトリ単位で転送します。

npm run deploy -- apps/hello --pin --launch

manifestはPC側で検査され、ファイルごとにPCとデバイスでSHA-256を確認します。既定では同名ファイルを置換します。置換を禁止する場合は --no-replace を指定してください。転送前にHomeへ戻ります。アプリの転送はフラットなディレクトリに対応し、サブディレクトリの再帰転送には対応していません。

MCPの cyd_app_deploy では、アプリを配置する親フォルダを指定して起動します。

$env:CYD_DESKTOP_APPS_ROOT = Join-Path (Get-Location) "apps"
npm start

この状態で app_dir: "hello" を指定すると、apps/hello を転送できます。未設定時の検索ルートは examples/ です。公開版でサンプルを含めない場合は、上記のように自分のアプリフォルダを設定してください。1ファイルの転送には cyd_package_upload を使い、バイナリは encoding: "base64" で渡せます。

アプリは cyd.update() を定期的に呼び、入力処理・描画・停止要求を処理します。戻り値が False になったらループを終了してください。keepaliveを行わない無限ループは、15秒のTask Watchdogによる再起動の対象です。ストレージ値の書込み上限は512バイト、JSON checkpointは4096バイトです。Wi-Fi/HTTP補助APIは無線モードがWi-Fiのときだけ使えます(それ以外では理由付きの RuntimeError)。現在の cyd.http_get() はHTTPのみで、HTTPSには対応していません。

画面に何も描かないスクリプトの print() 出力は画面に表示され、例外で止まったときはトレースバックが画面に残ります(Homeで閉じる)。

無線モードとBluetoothキーボード

Wi-FiとBluetoothはメモリに同時に載らないため、どちらを使うかを Settings > WIRELESS で選びます。初期値はOFFです。別のモードを選ぶと確認が出て、再起動後に切り替わります。Home表示中の空きヒープの目安は、OFF/Wi-Fiで約146 KB、Bluetoothで約54 KBです。

モード

使えるもの

OFF

Wi-FiもBluetoothも使わない。メモリが最も多く残る

WI-FI

cyd.wifi_*、cyd.http_get()、network/espnow(接続先は /sd/wifi.json)。他のモードではファームウェアがWi-Fiの起動を拒否します

BLUETOOTH

Bluetoothキーボード

ペアリング

  1. Settings > WIRELESS で BLUETOOTH を選び、再起動します。

  2. Wirelessページの KEYBOARD > を開き、キーボードをペアリングモードにしてから SCAN を押します。

  3. 見つかったキーボードの行をタップします。画面に大きく出た数字(毎回ランダム)をキーボードで打ち、Enterを押します。

  4. 「PAIRED」と出たら完了です。KEYS JIS/KEYS US でキー配列を選びます(初期値はJIS)。

キーボードは1台だけ記憶します。別のキーボードをペアリングすると前のキーボードは忘れ、FORGET で記憶を消せます。スリープしたキーボードはキーを押すと自動で再接続しますが、つながるまでに押したキーは届きません。タスクバー右端の記号は、接続中が緑、ペアリング済みで未接続が黄色で、接続・切断の瞬間には3秒間の通知が出ます。

キーの使い方

  • エディタ:接続中は画面キーボードを隠して16行を表示します。矢印、Home/End、PageUp/PageDown、Tab/Shift+Tab、Enter(字下げを引き継ぎ、: の後は1段深く)、Delete、Ctrl+S(保存)、Ctrl+O(開く)が使えます。1ファイル約1 KBまでです。

  • コンソール(examples/console):接続中は21行表示になり、↑↓で履歴、: で始まるブロックは空行で実行、Ctrl+Cで入力の取消や実行中コードの中断ができます。

  • アプリ:cyd.key() でキーを受け取ります。Ctrl+Cは実行中のアプリに KeyboardInterrupt を送ります。詳しくは cyd APIリファレンス の「ハードウェアキーボード」を参照してください。

Bluetoothモードの制限

  • Bluetooth用に24 KBを残すため、MicroPythonのヒープはそれ以上に広がりません。大きなメモリを使うアプリは MemoryError で止まります。

  • MJPプレイヤーの動画は再生できません(約49 KB必要)。OFFかWi-Fiモードで再生してください。

  • 対応するのはBluetooth Classicのキーボードです。このファームウェアで試した機種はSKB-BT23BKです(KB-PLT8990-Kは開発中の検証用ファームウェアでキー入力まで確認)。

USB JSON Lines

UART0はUTF-8 JSON Lines専用です。対話REPLは無効化しています。各JSONオブジェクトを改行で区切って送ります。

{"id":"status-1","command":"desktop_status"}
{"id":"clock-1","command":"desktop_launch","app_id":"clock"}
{"id":"game-1","command":"desktop_launch","app_id":"neon3d"}
{"id":"home-1","command":"desktop_home"}
{"id":"sd-1","command":"desktop_sd_status"}
{"id":"script-1","command":"desktop_script_launch","app_id":"hello"}
{"id":"tree-1","command":"desktop_ui_tree","offset":0,"limit":4}
{"id":"radio-1","command":"desktop_radio_status"}
{"id":"key-1","command":"desktop_key","key":"CTRL+S"}
{"id":"pause-1","command":"desktop_pause"}
{"id":"step-1","command":"desktop_step"}
{"id":"resume-1","command":"desktop_resume"}

hello の起動例は、上記アプリのインストール後に利用できます。

ファームウェアのビルドと書込み

ビルドせずに書き込むだけなら、公開リポジトリの Releases にあるビルド済みの zip を使えます。手順とリリースの作り方は ビルド済みファームウェア にあります。

ESP-IDF v5.5.2 と MicroPython v1.29.0 でビルドします。MicroPython のソースは、上流の v1.29.0 を無改変のまま firmware/micropython にサブモジュールとして同梱しています(取得は git submodule update --init firmware/micropython)。ESP-IDF とツールチェーンは同梱せず、別に用意します。

WindowsでのQSTR生成時のコマンド行長制限を避けるため、WSLでビルドします。以下は構築済みの開発環境での増分ビルド手順です。WSLの用意、ESP-IDFの導入、サブモジュールの取得、初回設定は ビルド環境を一から作る にあります。

Windows側でこのリポジトリのルートを開き、次を実行します(WSLはWindowsのカレントディレクトリで起動します)。

wsl -d Ubuntu-24.04 -e bash -c 'export IDF_TOOLS_PATH=~/cyd-desktop-vendor/.idf-tools && . ~/cyd-desktop-vendor/esp-idf/export.sh > /dev/null && cd firmware/micropython/ports/esp32 && idf.py -B build-cyd_desktop_board build'

ビルド設定は、初回に次のパスを指定して作られています(詳しくはビルド手順の資料)。

設定

このプロジェクト内の参照先

MICROPY_BOARD_DIR

firmware/cyd_desktop_board

USER_C_MODULES

firmware/cyd_desktop_shell/micropython.cmake

シェルは screen_*.cpp などへ分割されており、コンパイル対象の正本は firmware/cyd_desktop_shell/micropython.cmake です。

ビルド結果を、同じくリポジトリのルートへコピーします。

wsl -d Ubuntu-24.04 -e bash -c 'b=firmware/micropython/ports/esp32/build-cyd_desktop_board; cp "$b/micropython.bin" "$b/bootloader/bootloader.bin" "$b/partition_table/partition-table.bin" .'

ファームウェアは Bluetooth を含むため、アプリパーティションは 3 MB です(firmware/cyd_desktop_board/partitions-cyd.csv)。未書込みの基板と、Bluetooth 対応より前のファームウェアが入った基板では、bootloader とパーティションテーブルも書き込みます。ポートを確認し、他のシリアル接続を閉じてから実行してください。NVS の位置は変わらないので、タッチ補正と設定は残ります。

python -m esptool --port COM6 --before default_reset write_flash 0x1000 bootloader.bin 0x8000 partition-table.bin 0x10000 micropython.bin

以降はアプリパーティションだけの更新で足ります。

python -m esptool --port COM6 --before default_reset write_flash 0x10000 micropython.bin

開発用テストの現状

次のコマンドでホスト側検証を実行できます。実機は不要です。

npm test
# C++とPythonの検証。WSLにg++とpython3が必要(npm run test:native でも可)
wsl bash tools/run-native-tests.sh

2026-09-14の確認では、JavaScript 59件、C++ 7組、Pythonのmanifest検証が成功し、スキップは0件でした。npm audit の既知脆弱性は0件でしたが、これは確認時点のnpm依存に対する結果です。ファームウェア全体の安全性を保証するものではありません。

ネイティブテストスクリプトはコンパイル失敗を SKIP として扱うため、終了コードだけでなく failed と skipped の両方を確認してください。g++が無い環境(WindowsのGit Bashなど)では全件が SKIP になります。

ライセンス

本体の独自コードは MIT License — Copyright (c) 2026 manymids です。

Adafruit由来フォントはBSD 2-Clause、MicroPython本体はMITです。第三者由来部分にはそれぞれのライセンスが適用されます。ファームウェアのバイナリを配布する場合はライセンス資料を添付し、実際のビルドに含まれる追加部品の表示も確認してください。現在の資料は、全リンク部品のライセンス監査完了を示すものではありません。

Available Tools

42 tools
arcl_statusA

Common (arcl). Control, any layer. Report the machine id, enabled layers, current view and foreground app, and the MicroPython app runtime. time_control is "none": the board runs in real time and has no frame counter, so frame is null.

Inputs: no named parameters.

cyd_activateC

Machine-specific (cyd). Action, L1. Same as cyd_launch. Kept for clients written against the older name.

Inputs: app_id (required).

cyd_app_deleteB

Machine-specific (cyd). Action, L1. Permanently delete one installed MicroPython app and any Home shortcut that targets it.

Inputs: app_id (required).

cyd_app_deployB

Machine-specific (cyd). Action, L1. Install or update a whole app directory - manifest.json, the entry file and every asset, binary included - after checking the manifest. app_dir is resolved inside CYD_DESKTOP_APPS_ROOT, which defaults to the repository's examples directory. Returns to Home first, because the device refuses uploads while an app runs.

Inputs: app_dir (required), pin, launch, replace.

cyd_app_errorA

Machine-specific (cyd). Observation, L2. Read the full traceback of the most recent MicroPython app failure. The event log keeps only a 48-character summary.

Inputs: no named parameters.

cyd_apps_listA

Machine-specific (cyd). Observation, L1. List the ids of the built-in views and native apps, as a fixed list kept in the firmware. Installed MicroPython apps are listed by cyd_installed_apps_list.

Inputs: no named parameters.

cyd_bt_connectA

Machine-specific (cyd). Action, L3. Pair with a keyboard from the last scan by index. The screen shows a PIN or passkey (also in cyd_bt_status) that the user types on the keyboard, then Enter. Pairing a keyboard forgets the previous one.

Inputs: index (required).

cyd_bt_forgetB

Machine-specific (cyd). Action, L3. Disconnect and forget the remembered Bluetooth keyboard.

Inputs: no named parameters.

cyd_bt_scanA

Machine-specific (cyd). Action, L3. Search for Bluetooth Classic keyboards in pairing mode for the given seconds. Poll cyd_bt_status for results.

Inputs: seconds.

cyd_bt_statusA

Machine-specific (cyd). Observation, L3. Read the Bluetooth keyboard state: connected and remembered keyboard, pairing progress with the PIN or passkey to type, and the results of the last scan. Bluetooth runs only in radio mode bluetooth.

Inputs: no named parameters.

cyd_diagnosticsA

Machine-specific (cyd). Observation, L2. Read desktop transport and health diagnostics. fingerprint: 1 starts summing the CRC-32 of everything sent to the LCD (spi_fingerprint, from zero), 0 stops it; two firmware builds that paint identically produce the same change over the same actions.

Inputs: fingerprint.

cyd_homeB

Machine-specific (cyd). Action, L1. Return the foreground application to Home.

Inputs: no named parameters.

cyd_input_clearB

Machine-specific (cyd). Action, L0. Read the most recent input event and clear it.

Inputs: no named parameters.

cyd_input_macroC

Machine-specific (cyd). Action, L0. Queue a short sequence of coordinate taps with optional delays between steps.

Inputs: steps (required).

cyd_input_readA

Machine-specific (cyd). Observation, L0. Read the most recent input event, such as tap.home or tap., without clearing it.

Inputs: no named parameters.

cyd_input_stateA

Machine-specific (cyd). Observation, L0. Read physical touch state, last coordinate, and queued synthetic tap count.

Inputs: no named parameters.

cyd_installed_apps_listB

Machine-specific (cyd). Observation, L1. List MicroPython apps installed on the microSD, including Home pin state.

Inputs: no named parameters.

cyd_key_pressA

Machine-specific (cyd). Action, L0. Press one key as a hardware keyboard would: the editor edits with it and a running app reads it with cyd.key(). Names: a character ("a", "A"), ENTER, BACKSPACE, DELETE, TAB, ESC, UP, DOWN, LEFT, RIGHT, HOME, END, PAGEUP, PAGEDOWN, INSERT, F1-F12, with CTRL+, ALT+ or SHIFT+ in front (CTRL+S). CTRL+C interrupts a running app.

Inputs: key (required).

cyd_launchA

Machine-specific (cyd). Action, L1. Open a built-in view (clock, calendar, scripts, settings, editor), a native app, or an installed MicroPython app by id. A MicroPython app is queued: success means it will start, not that it has.

Inputs: app_id (required).

cyd_logsB

Machine-specific (cyd). Observation, L2. Read the retained recent UI, input, and application event log.

Inputs: no named parameters.

cyd_package_uploadA

Machine-specific (cyd). Action, L1. Atomically upload one file into /sd/apps/<app_id>/ after SHA-256 verification. Text by default; pass encoding "base64" for binary assets such as JPEG images. Existing files are kept unless replace is true. Fails while a foreground app is running.

Inputs: file (required), app_id (required), content (required), replace, +1 more.

cyd_pauseB

Machine-specific (cyd). Control, any layer. Cooperatively pause the foreground MicroPython app at its next cyd.update().

Inputs: no named parameters.

cyd_radio_setA

Machine-specific (cyd). Action, L3. Store the radio mode (off, wifi or bluetooth) for the next boot. It applies after a restart; restart true restarts the device right after replying, which fails while a foreground app is running.

Inputs: mode (required), restart.

cyd_radio_statusA

Machine-specific (cyd). Observation, L3. Read the radio mode of this boot (off, wifi or bluetooth) and the mode stored for the next boot. Wi-Fi and Bluetooth are exclusive.

Inputs: no named parameters.

cyd_resumeB

Machine-specific (cyd). Control, any layer. Resume a cooperatively paused MicroPython app.

Inputs: no named parameters.

cyd_runB

Machine-specific (cyd). Control, any layer. Pause the cooperative MicroPython app and grant a bounded number of cyd.update() frames.

Inputs: frames (required).

cyd_runtime_statusC

Machine-specific (cyd). Control, any layer. Read cooperative MicroPython runtime pause and frame state.

Inputs: no named parameters.

cyd_screen_mirrorA

Machine-specific (cyd). Observation, L0. Render a lightweight logical 320x240 PNG mirror from the retained UI tree. This is not an LCD pixel readback.

Inputs: no named parameters.

cyd_script_launchC

Machine-specific (cyd). Action, L1. Launch /sd/apps/<app_id>/main.py as the single foreground MicroPython app.

Inputs: app_id (required).

cyd_sd_statusA

Machine-specific (cyd). Observation, L3. Read whether the optional FAT microSD card was mounted safely at boot.

Inputs: no named parameters.

cyd_settings_getA

Machine-specific (cyd). Observation, L1. Read brightness, color theme, animation speed, and Bluetooth keyboard layout settings.

Inputs: no named parameters.

cyd_settings_setB

Machine-specific (cyd). Action, L1. Persist one or more settings. Omitted settings remain unchanged. keyboard_layout is the key layout of a Bluetooth keyboard.

Inputs: theme, animation, brightness, keyboard_layout.

cyd_shortcut_createA

Machine-specific (cyd). Action, L1. Create a new microSD-backed Home shortcut. Home shows two shortcuts on its first page and eight on each further page, 18 in all.

Inputs: title (required), app_id (required), shortcut_id (required).

cyd_shortcut_deleteC

Machine-specific (cyd). Action, L1. Delete a microSD-backed Home shortcut.

Inputs: shortcut_id (required).

cyd_shortcuts_listA

Machine-specific (cyd). Observation, L1. List the microSD-backed Home shortcuts currently loaded by the desktop.

Inputs: no named parameters.

cyd_shortcut_updateC

Machine-specific (cyd). Action, L1. Update an existing microSD-backed Home shortcut.

Inputs: title (required), app_id (required), shortcut_id (required).

cyd_stepA

Machine-specific (cyd). Control, any layer. Advance a cooperatively paused MicroPython app by one cyd.update() frame.

Inputs: no named parameters.

cyd_tapA

Machine-specific (cyd). Action, L0. Queue a synthetic tap at an absolute 320x240 display coordinate.

Inputs: x (required), y (required).

cyd_time_setB

Machine-specific (cyd). Action, L1. Synchronize the CYD clock from a Unix epoch.

Inputs: epoch (required).

cyd_touch_calibrate_startA

Machine-specific (cyd). Action, L3. Show the first of three touch-calibration crosshairs. Tap each crosshair once to save the corrected mapping.

Inputs: no named parameters.

cyd_type_textA

Machine-specific (cyd). Action, L0. Type text as hardware keyboard presses, one key per character; a newline is ENTER. Printable ASCII only.

Inputs: text (required).

cyd_ui_treeA

Machine-specific (cyd). Observation, L0. Read the detailed currently visible UI tree with ids, roles, labels, bounds, and enabled state.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 42 tools

    Disambiguation4/5

    Most tools map to a distinct subsystem and action, and descriptions clearly separate closely related groups like app listing versus installed MicroPython apps. The main ambiguity is an explicit alias (cyd_launch/cyd_activate) and a few read-versus-clear or launch-versus-script variants, but descriptions mostly prevent misselection.

    Naming Consistency4/5

    Names largely follow a consistent cyd_<subsystem>_<action> pattern with snake_case throughout. Minor deviations such as noun-only names (cyd_logs, cyd_diagnostics) and the common arcl_status tool keep it from being perfectly uniform.

    Tool Count2/5

    42 tools is well above the comfortable MCP tool count and will be heavy for an agent to navigate. Many fine-grained operations could be consolidated into parameterized tools, and the launch/activate alias inflates the count further.

    Completeness4/5

    The surface covers core device control well: UI observation, input synthesis, app lifecycle, settings, Bluetooth, radio, and shortcuts. Minor gaps like an explicit app-stop or standalone reboot tool and generic SD file browsing prevent a perfect score.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables remote control of Android devices via ADB, including screen operations, input, app management, file transfer, and advanced tools like UI testing and performance analysis.
      25
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables interaction with ESP32/MicroPython boards via tools for flashing firmware, running REPL code, file management, and serial capture, with support for progress notifications, cancellation, and error handling.
      8
      MIT
    • F
      license
      B
      quality
      C
      maintenance
      Enables local, cloud-free control of a Uitree Portal APK via 27 MCP tools for UI tree inspection, screenshots, tapping/swiping, input, clipboard, app/file management, APK installation, and keep-awake.
      30
      -