ARCL CYD Desktop MCP bridge
Allows pairing and managing Bluetooth Classic keyboards, selecting JIS/US layout, and forwarding key input to the editor, console, and apps on the CYD device.
Allows installing, launching, and deleting MicroPython apps on the device, running scripts, capturing print output and errors, and pausing, stepping, and resuming execution.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ARCL CYD Desktop MCP bridge Show the current UI tree and diagnostics on the CYD"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
開発者向けドキュメント
公開ドキュメント一覧:各資料の用途と過去の記録を読む際の注意
cyd APIリファレンス:MicroPythonアプリの開発・インストール
ネイティブアプリの追加手順:C++アプリの実装・登録・ビルド
ビルド環境を一から作る:WSL、ESP-IDF v5.5.2の導入、同梱したMicroPython v1.29.0(サブモジュール)の取得から書き込みまで
ビルド環境の基線:ESP-IDF/MicroPythonとWSL構成を決めた経緯(開発段階の記録)
MCP操作・観測インターフェース:UIツリー・入力・診断・実行制御
MCPツール一覧:全ツールの種別・レイヤ・引数
対象環境
項目 | 内容 |
ボード | 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( |
USBシリアル | CH340(VID |
次の基板は対応していません:液晶が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 --launchmanifestは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 |
|
BLUETOOTH | Bluetoothキーボード |
ペアリング
Settings > WIRELESS で BLUETOOTH を選び、再起動します。
Wirelessページの KEYBOARD > を開き、キーボードをペアリングモードにしてから SCAN を押します。
見つかったキーボードの行をタップします。画面に大きく出た数字(毎回ランダム)をキーボードで打ち、Enterを押します。
「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'ビルド設定は、初回に次のパスを指定して作られています(詳しくはビルド手順の資料)。
設定 | このプロジェクト内の参照先 |
|
|
|
|
シェルは 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.sh2026-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 です。
LICENSE:本体のMITライセンス
THIRD_PARTY_NOTICES_ja.md:第三者コードの由来・条件・配布時の注意
licenses/:第三者ライセンスの原文
Adafruit由来フォントはBSD 2-Clause、MicroPython本体はMITです。第三者由来部分にはそれぞれのライセンスが適用されます。ファームウェアのバイナリを配布する場合はライセンス資料を添付し、実際のビルドに含まれる追加部品の表示も確認してください。現在の資料は、全リンク部品のライセンス監査完了を示すものではありません。
Available Tools
42 toolsarcl_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
Scored across 42 tools
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.
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.
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.
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
Drive real devices from your AI Coding tool. Embed a client SDK (Unity, Godot, Flutter, iOS/macOS, Android, React Native, Web) in your app, then capture screenshots, traverse the UI tree, inject taps and key events, and run automated test tasks on the physical device over a secure relay.
remote debug iOS/Android/Unity/Godot/Flutter/RN/Web on real-device.ui-tree/screenshots/taps,tests.
Securely control computers you explicitly pair through files, terminals, processes, screenshots, desktop UI/input, clipboard, browser automation, diagnostics, and document tools.
Turns a phone into a camera+Bluetooth remote so AI assistants can see and control any PC.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables remote control of Android devices via ADB, including screen operations, input, app management, file transfer, and advanced tools like UI testing and performance analysis.25MIT
- FlicenseBqualityDmaintenanceMCP server for controlling MicroPython devices (ESP32, RP2040, etc.) via USB Serial or WebREPL, enabling code execution, file operations, and device management from MCP clients.299-
- AlicenseAqualityDmaintenanceEnables 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.8MIT
- FlicenseBqualityCmaintenanceEnables 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-