mcpField
M
metavr-cli

metavr-cli

github.com/meta-quest開発241232 回インストール5 週間前に更新
リポジトリ

metavr-cli について

metavr-cliは、Meta VRとHorizon OSの開発者向けコマンドラインツールです。ADBとMetaの開発者APIをまとめ、デバイス管理、ドキュメント検索、Perfetto分析を行えます。

主な機能

  1. 01デバイスとアプリのライフサイクル管理
  2. 02Meta VRのドキュメントとアセットの検索
  3. 03スクリーンショット撮影と音声制御
  4. 04テストデバイスの準備とログ確認
  5. 05Perfettoトレースの取得と分析

活用シーン

  1. 01ヘッドセットへのアプリのインストールと起動
  2. 02デバイス状態の確認とテスト環境の設定
  3. 03開発中のMeta VR APIの検索
  4. 04デバイスのパフォーマンストレース分析

MCP 対応

metavrはMCPサーバーを内蔵し、デバイス管理、アプリのライフサイクル、トレース分析、ドキュメント検索、ファイル操作、3Dアセット検索のツールを公開します。`metavr mcp server`で起動でき、`metavr mcp install`で対応するAIツールに設定を追加できます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/meta-quest/agentic-tools --skill metavr-cli

インストール後、Claude Code で/metavr-cliを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
metavr-agent-workflows.md
metavr-app-management.md
metavr-dev-tools.md
metavr-device-management.md
metavr-docs-search.md
metavr-perf-tools.md

詳細

metavr CLI リファレンス

metavr の機能

metavr（Meta VR CLI）は、Meta VR および Horizon OS 開発向けの CLI です。 ADB と Meta の開発者 API を、高レベルのコマンドで利用できるようにします。デバイス管理、アプリのライフサイクル管理、ドキュメント検索、スクリーンショット撮影、オーディオ制御、テストデバイスの準備、MCP 連携、Perfetto によるパフォーマンス分析に対応しています。

この SKILL.md はルーティング層として使用してください。正確なフラグと完全なコマンド構文については、生成された CLI リファレンス全体を docs/metavr-cli.md で確認するか、次を実行してください。

metavr --markdown-help

インストール

まず metavr CLI をインストールしてください。

スタンドアロンバイナリ

スタンドアロンバイナリは PATH に配置されます（前提条件はありません）。

# macOS and Linux
curl -fsSL https://developers.meta.com/horizon/install-cli/ | sh

# Windows (PowerShell)
iwr -useb https://developers.meta.com/horizon/install-cli/windows/ | iex

インストーラーによって metavr が PATH に追加されます（反映するには、シェルの rc ファイルを読み込むか、新しいターミナルを開いてください）。スタンドアロンバイナリをインストールした場合は、metavr update で最新の状態に保ってください。

npm ディストリビューション

npm ディストリビューションには Node.js 16 以降が必要で、別途インストールする必要はありません。

npx -y metavr --version

または、npm install -g metavr でグローバルにインストールできます（後で更新するには npm update -g metavr を実行してください）。

以降のドキュメントの例では、metavr コマンドをそのまま使用しています。npm ディストリビューションを使用する場合は、先頭に npx -y を付けてください（例：npx -y metavr device list）。

デバイス接続

デバイス上でコマンドを使用する前に、次の操作を行ってください。

  1. Meta VR デバイスで 開発者モード を有効にします（設定 > システム > 開発者）
  2. プロンプトが表示されたら USB デバッグ を有効にします
  3. Meta VR デバイスを USB-C でコンピューターに接続します

接続を確認します。

metavr device list

デバイスが表示されない場合は、別の USB ケーブル（充電専用ではなく、データ転送に対応したもの）を試すか、ヘッドセットで USB デバッグの確認プロンプトを承認するか、metavr device connect <ip> でワイヤレス接続してください。

コマンドの確認

段階的に詳細を確認してください。

  1. まずこのスキルで、コマンドグループと一般的なワークフローを確認します。
  2. ユーザーが特定の領域に取り組んでいる場合は、該当するリファレンスファイルを開きます。
  3. 正確なフラグや引数、あまり使われないサブコマンドについては、docs/metavr-cli.md または metavr --markdown-help を使用します。

現在のトップレベルのコマンドグループは次のとおりです。

グループ用途
adb / shell低レベルの ADB 互換コマンドと、デバイスシェルへの直接アクセス
appアプリのインストール、一覧表示、起動、停止、クリア、確認、フォアグラウンドアプリの検出
assetMeta の 3D アセットライブラリを検索
audioデバイスの音量の取得、設定、ミュート、ミュート解除
capture接続中のヘッドセットからスクリーンショットを撮影
configmetavr の設定の読み取り、書き込み、リセット、一覧表示
deviceデバイスの一覧表示と接続、ADB の状態待機、コントローラーの確認、テストデバイスの設定、ヘルスチェックの実行、近接センサーの管理
docsMeta VR ドキュメントと API リファレンスの項目を検索・取得
filesデバイス上のファイルやディレクトリの一覧表示、取得、送信、削除、作成
log最近のデバイスログを表示。高度なフィルターやストリーミングには adb logcat を使用
mcpAI ツール向けの metavr MCP サーバーを起動またはインストール
perfPerfetto トレースの取得、オープン、分析、クエリ、比較、管理

MCP サーバーモード

metavr には、AI エージェントが Meta VR デバイスをプログラムから操作できる、約 40 個のツールを備えた MCP（Model Context Protocol）サーバーが組み込まれています。

MCP サーバーを使用するには、任意の MCP 設定に次のコマンドを追加してください。

metavr mcp server

このサーバーは、デバイス管理、アプリのライフサイクル管理、パフォーマンストレース分析、ドキュメント検索、ファイル操作、3D アセット検索用のツールを提供します。

他の AI ツールに MCP 設定をインストールします。

metavr mcp install cursor
metavr mcp install claude-desktop
metavr mcp install vscode

プロジェクト単位でエージェントを設定するには、現在のリポジトリに MCP 設定をインストールしてください。

cd your-project
metavr mcp install project

コーディングエージェントがホストマシン上のリポジトリにすでにアクセスでき、そのプロジェクトから metavr ツールを呼び出す必要がある場合は、この方法が最適です。

共通のエージェントワークフロー

Meta VR ネイティブの開発者ツールを構築する場合や、Meta VR ヘッドセットの UI とホスト側のコーディングエージェントを連携させる場合は、アーキテクチャをシンプルに保ちます。

  • ホスト側のコーディングエージェントに、リポジトリへのアクセス、ファイル編集、ビルド、テスト、metavr ツールの呼び出しを任せます
  • ヘッドセットアプリまたはブラウザーでのエクスペリエンスは、プレビュー、プロンプトの取得、ステータス、承認を担う薄いクライアントとして動作させます
  • metavr mcp install project を使ったプロジェクトローカルの MCP インストールを優先し、連携を明示してリポジトリと一緒に移動できるようにします
# 1. Verify the current docs before coding against an API or workflow
metavr docs search "spatial sdk panel"
metavr docs fetch https://developers.meta.com/horizon/documentation/...

# 2. Build and deploy your app
./gradlew assembleDebug
metavr app install app/build/outputs/apk/debug/app-debug.apk
metavr app launch com.example.app

# 3. Observe on-device behavior
metavr log --tag MyApp
metavr capture screenshot -o latest.png

# 4. Prepare a stable test device when running repeatable tests
metavr device health-check
metavr device configure-testing setup
# ...run tests...
metavr device configure-testing restore

ADB との関係

metavr は ADB をラップし、より高レベルのコマンドを提供します。ほとんどの Meta VR 開発タスクでは、adb を直接使う必要はありません。metavr はデバイスの選択を処理し、構造化された出力を提供するとともに、生の ADB ではサポートされない Meta VR 固有の機能（metacam によるスクリーンショット、Perfetto トレース分析、ドキュメント検索）を追加します。

デバイスへの生のシェルアクセスが必要な場合は、metavr shell または metavr adb shell を使います。

コマンドリファレンス全文

生成されたコマンドの詳細については、docs/metavr-cli.md を参照してください。次のコマンドで再生成できます。

metavr --markdown-help > docs/metavr-cli.md

参考資料

ワークフロー、例、トラブルシューティングを含む詳細な使用ガイドについては、以下を参照してください。

  • デバイス管理 — デバイスコマンド、オーディオ、スクリーンショット、ログ、テストのセットアップ、ヘルスチェック、シェルアクセス
  • アプリ管理 — アプリのライフサイクル、フォアグラウンドアプリの検出、クラッシュのデバッグ、一般的なログタグ
  • エージェントのワークフロー — プロジェクトローカルの MCP インストール、ドキュメントの検証、安全性、薄いクライアントのアーキテクチャ
  • パフォーマンスツール — トレースのキャプチャ、ガイド付き分析、Perfetto UI、SQL クエリ、比較、GPU カウンター
  • ドキュメント検索 — ドキュメント検索、API 検索、カテゴリによるフィルタリング
  • 開発者ツール — metavr tools を使ったシミュレーター、デバッガー、SDK のインストール、更新、起動

コメント

Markdown 対応