メインコンテンツへ移動

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_readSkill の主ファイルまたは参照ファイルをページ単位で読み取ります。読み取り専用

呼び出し例​

  • 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 配列で、各項目は内部 ID tool、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"}}