MCP ツールリファレンス
MCP は業務ツール名、用法の定義、業務呼び出し、Skill 一覧、Skill 文書の読み取りを担当する tool_list、tool_info、tool_call、skill_list、skill_read の五つを公開します。一覧は必要な場合のナビゲーションです。業務の照会、変更、端末操作はすべて tool_call を使用し、tool が必須です。既知の操作は直接呼び出せます。Skill と参考文書は必要に応じて読み取ります。 args は業務引数を含む任意のオブジェクトです。
| ツール | 説明 | 効果 |
|---|---|---|
tool_list | 業務ツール名を返し、カテゴリで絞り込めます。 | 読み取り専用 |
tool_info | 指定ツールの説明、引数スキーマ、効果を返し、業務操作は実行しません。 | 読み取り専用 |
tool_call | 業務ツールを呼び出し、照会・変更・デバイス操作を実行します。 | 業務ツールによる |
skill_list | 組み込み Skill の名前、説明、読み取り・ダウンロード案内を返します。 | 読み取り専用 |
skill_read | Skill の主ファイルまたは参照ファイルをページ単位で読み取ります。 | 読み取り専用 |
呼び出し例
tool_list({}):versionと並べ替えられたtoolsの名前リストを返します。tool_list({category:"devices"}):categoryでカテゴリ別に操作名を絞り込みます。tool_info({tools:"backend_list_devices"}): 単一ツールの用法を説明し、ツールは実行しません。tool_info({tools:["backend_list_devices","device_get_status"]}): 必要な複数のツールの用法を説明し、実行しません。結果はtools配列で、各項目は内部 IDtool、description、inputSchema(tool_call.args用)、readOnlyを含みます。toolsは空でない文字列、または空でない文字列配列で、まとめて取得する件数に固定の上限はありません。tool_call({tool:"backend_list_devices",args:{limit:10}}): 既知のツールを直接呼び出して必要な端末一覧を読み取ります。skill_list({}): Skill の名前、説明、readCallヒントを一覧表示します。skill_read({skill:"xxtlancontrol"}): 名前が分かっていれば主 Skill を直接読み取ります。pathの既定値はSKILL.mdです。skill_read({skill:"xxtlancontrol",path:"references/tasks.md"}): 主 Skill の相対リンクに沿って手順を読み取ります。cursor/maxBytesによるページ分割を利用できます。
アプリの呼び出しヒント readCall、infoCall、listCall は {name,args} を使い、name で公開 MCP ツールを指定します。 Skill ID は一覧の skills[].skill、読み取り結果の data.skill に返されます。
skill_list の各項目は、現在の中控で完全な Skill ZIP を取得する完全 URL downloadUrl を提供します。skill_read は選択した単一ファイルのテキストを返し、Skill パッケージ全体のダウンロードリンクも含みます。ZIP には主文書、参考文書、付属のスクリプト、テンプレート、素材が含まれます。ダウンロードのみなら一覧のメタデータで十分です。既存のリンクは、本文を読んだり一覧を再取得したりせず直接利用できます。
名前が不明な場合はカテゴリ別に tool_list を参照し、引数が不明な場合は tool_info で必要な定義をまとめて取得してから tool_call を使います。既知のツールは一覧や定義を先に読まず直接呼び出せます。
一括操作でタスク ID が返されたら、状態と失敗項目を確認します。中控の更新後は MCP に再接続してください。
デバイスでシェルコマンドを実行
MCP 設定で「デバイスでのシェルコマンドの実行を許可」をオンにして保存すると、デバイスでシェルコマンドを実行できます。既定ではオフです。オフにして保存すると、すべての MCP セッションでツールが非表示になり、新しい呼び出しは拒否されます。
command は完全なコマンドラインで、最大 16384 文字です。デバイス側のシェルが -c で実行します。結果には終了コード、標準出力、標準エラー出力と、roothide シェルでのパスに関する注意が含まれます。
コマンドのタイムアウトは既定で 10 秒です。時間のかかる処理では timeoutMs(例:5 分なら 300000)を設定し、MCP クライアント側でも十分な時間を確保してください。コントローラは開始時に aux の有効時間を更新し、実行中は 30 秒ごとにデバイスとハートビートを交換します。最後のタスクが完了してから 180 秒間操作がないと aux は終了します。
{"tool":"device_run_shell_command","args":{"udid":"DEVICE_UDID","command":"df -h"}}