nvidia-app

NVIDIA App MCP オーバーレイ

目的

NVIDIA App をローカル MCP サーバー経由で操作する場合に、このスキルを使用します。ルーティングされるモードは 2 つあります。

• NVIDIA App の一般的な操作では、アプリケーションの一覧表示と起動、ドライバーの状態とリリースノート、ゲームごとの最適化、ノート PC 機能を扱います。
• ゲーム内オーバーレイの操作では、以下のワークフローを使用します。

オーバーレイのワークフローでは、以下をサポートします。

• オーバーレイの概要ステータスを読み取ります。
• ゲームプレイの録画を開始または停止します。
• インスタントリプレイを有効化、無効化、または保存します。
• ハイライトを有効化または無効化します。
• スクリーンショットをオーバーレイギャラリーにキャプチャします。
• 統計オーバーレイを表示または非表示にします。
• RTX ダイナミックビブランスフィルターを有効化または無効化します。
• 現在実行中のゲームを特定します。

接続設定では両方のモードをサポートしますが、追加の操作は許可されません。

このスキルを使用する場合

ユーザーから、サポート対象のアプリケーション、ドライバー、ゲーム最適化、ノート PC 機能、オーバーレイ、または接続ワークフローを依頼された場合に、このスキルを使用します。

デスクトップキャプチャ、その他のオーバーレイフィルターの変更、NVIDIA Broadcast、OBS、Xbox Game Bar、またはその他のキャプチャソフトウェアには、このスキルを選択しないでください。

入力

• 必須： サポート対象の NVIDIA App に関する問い合わせ、変更、または接続診断のユーザーリクエスト。
• 任意： 明示的な目標状態、ゲームまたはプログラムの識別子、ツール固有の値、クライアントの接続情報。認証トークンは、references/connection.md に記載されている保護された検出元からのみ取得してください。通常のツール引数として受け取ったり、公開したりしないでください。

情報は次の順序で解決します。明示的なユーザー指示、最新のライブ MCP スキーマまたは状態、現在のクライアント接続設定、静的な契約の詳細に関する該当する自己完結型スキルリファレンスです。以前のツール結果を現在の状態として扱わないでください。

前提条件

• NVIDIA App（バージョン 11.0.9.5xx 以降）がインストールされ、NvContainer がホストする MCP プラグインが実行中の Windows ホスト。
• NVIDIA App の標準実行ファイルのパス：%ProgramFiles%\NVIDIA Corporation\NVIDIA App\CEF\NVIDIA App.exe。
• NVIDIA App にマスタートグルが表示されている場合、MCP サーバーへのアクセスが有効になっています。
• いずれかの nvapp_overlay_ 呼び出しを行う前に、NVIDIA ゲーム内オーバーレイが有効化され、実行中で、準備完了している必要があります。
• MCP クライアントがループバック経由の Streamable HTTP をサポートしているか、インストール済みの stdio ブリッジ経由で接続している必要があります。

MCP サーバーの準備状態とオーバーレイの準備状態は別々です。MCP 接続に成功しても、オーバーレイツールの準備が完了したことにはなりません。

手順

1. リクエストを分類します。 一般的な NVIDIA App のリクエストは、ライブツールの検出を通じて処理します。nvapp_overlay_ リクエストは、Overlay ワークフローを通じて処理します。読み取り専用の Overlay ステータスに対象外の機能のフィールドが含まれていても、それらを変更する権限が与えられるわけではありません。
2. 現在の MCP クライアントに nvidia-app を登録するか、明示的にフォールバックします。 このセッションのライブツールカタログに nvapp_ ツールが表示されている場合にのみ、クライアントが登録済みとみなします。ループバックポートが開いていることや、stdio ブリッジが動作していることは、登録を意味しません。これらのツールが表示されない場合は、最初の nvapp_ 呼び出しより前に、references/connection.md に従って登録を試みてください。登録はターンやセッションをまたいで維持されるため、デフォルトの方法です。HTTP エンドポイントに接続できることを理由に、登録の試行を省略してはいけません。
3. 直接接続を使うのは、明示的なフォールバックとしてのみです。 ユーザーが設定変更を拒否した場合、クライアントを変更または再読み込みできない場合、あるいは登録に成功してもこのセッションに nvapp_ ツールが表示されない場合は、ループバック HTTP エンドポイント（または stdio ブリッジ）に直接接続し、同じ文書化済みのツール契約に従って続行します。使用した接続方法と、nvidia-app を登録すればアクセスが維持されることを伝えてください。直接接続を黙って優先してはいけません。
4. 一般ツールを検出します。 Overlay 以外のリクエストでは、確立した接続先で tools/list を調べ、7 つの文書化済み公開ツールから選択または呼び出す前に references/general-tools.md を読みます。ユーザーの対象範囲内の意図に最も厳密に一致する説明、スキーマ、アノテーションを持つ、返されたツールのみを選択し、より限定的なライブスキーマやアノテーションがあれば、それに従ってください。
5. Overlay の目標状態を確定します。 明示的な開始、停止、有効化、無効化、表示、非表示のリクエストでは、対応する変更操作を直接呼び出します。目標状態を指定しない真の切り替えリクエストでは、ステータスを一度読み取り、対応する Boolean のみを反転します。
6. 引数を検証します。 一般ツールでは、references/general-tools.md と、より限定的なライブスキーマがあればそれに従います。Overlay ツールでは、以下にマッピングされたフィールドのみを正確に使用します。サポートされていない引数を作り出してはいけません。
7. リクエストの順序どおりに実行します。 複合リクエストでは、サポートされる各操作を、ユーザーが指定した順序で個別のツール呼び出しとして実行します。リクエストされた操作に必要な呼び出しのみを行います。アクセスティアと同意の判断を尊重し、代替手段としてアクセス権を引き上げたり、別の機能を有効にしたりしてはいけません。
8. 結果を文字どおりに解釈します。 返されたフィールドと結果のみを報告します。Overlay の変更操作は、人が読めるメッセージを返すため、そのメッセージを報告し、存在しない構造化された成功フィールドを作り出してはいけません。変更操作のメッセージが曖昧な場合は、確認のためだけに後続の Overlay ステータス呼び出しを行うのではなく、結果を独立して確認できていないと伝えます。

接続

デフォルトの HTTP エンドポイントは次のとおりです。

http://127.0.0.1:13508/mcp

インストール済みの stdio ブリッジは次のとおりです。

%ProgramFiles%\NVIDIA Corporation\NVIDIA App\McpServer\NvAppMcpServer.exe

stdio 実行ファイルは永続サーバーにリクエストを中継します。サーバーを起動したり有効にしたりするものではありません。

NVIDIA App の一般的な操作

一般的な NVIDIA App ツールを選択または呼び出す前に、references/general-tools.md を読んでください。このファイルには、サポート対象の 7 つのツール名、正確な引数、列挙値、条件付きスキーマ、前提条件の確認方法が記載されています。

ライブの tools/list に表示された、文書化済みのツールのみを使用してください。パッケージに含まれる手順は自己完結しており、リポジトリ内部のスキーマソースに依存しません。

オーバーレイ操作

この表に記載されたツールと、ここに示された許可済みの引数のみを使用してください。

ユーザーの意図	ツール	引数
オーバーレイ全体の状態を読み取る	nvapp_overlay_get_status	{}
録画を開始する	nvapp_overlay_capture	{ "action": "toggle_recording", "enable": true }
録画を停止して保存する	nvapp_overlay_capture	{ "action": "toggle_recording", "enable": false }
インスタントリプレイを有効にする	nvapp_overlay_capture	{ "action": "toggle_instant_replay", "enable": true }
インスタントリプレイを無効にする	nvapp_overlay_capture	{ "action": "toggle_instant_replay", "enable": false }
インスタントリプレイを保存する	nvapp_overlay_capture	{ "action": "save_instant_replay" }
ハイライトを有効にする	nvapp_overlay_capture	{ "action": "toggle_highlights", "enable": true }
ハイライトを無効にする	nvapp_overlay_capture	{ "action": "toggle_highlights", "enable": false }
スクリーンショットを撮影する	nvapp_overlay_capture	{ "action": "capture_screenshot" }
統計情報オーバーレイを表示する	nvapp_overlay_configure_stats	{ "enable": true }
統計情報オーバーレイを非表示にする	nvapp_overlay_configure_stats	{ "enable": false }
RTX Dynamic Vibrance を有効にする	nvapp_overlay_configure_filters	{ "filter": "rtx_dvc", "enable": true }
RTX Dynamic Vibrance を無効にする	nvapp_overlay_configure_filters	{ "filter": "rtx_dvc", "enable": false }
現在のゲームを取得する	nvapp_overlay_get_current_game_info	{}

toggle_desktop_capture は決して呼び出さないでください。nvapp_overlay_configure_filters では、rtx_dvc フィルター値のみを使用してください。

キャプチャとプライバシー

toggle_recording、toggle_instant_replay、save_instant_replay、toggle_highlights、capture_screenshot は画面の内容を記録し、ユーザーのシステムにメディアファイルを書き込みます。録画とスクリーンショットは、ユーザーが削除するまで NVIDIA App Overlay ギャラリーに保存されます。このスキルでは、ファイル形式、解像度、保存先を指定できません。

これらはすべてプライバシーに影響する操作として扱ってください。

• 開始、停止、保存、有効化、撮影をユーザーが明示的に依頼した場合、その依頼が実行の許可になります。追加の確認を求めず、対応する呼び出しを1回実行してから、キャプチャが開始されたこと、またはメディアが書き込まれたことをユーザーが把握できるよう、返されたメッセージを伝えてください。
• ユーザーが求めていないキャプチャを開始してはなりません。別の依頼の副作用として録画を開始したり、失敗した操作の回避策として録画を開始したりしないでください。
• 依頼が曖昧な場合、真偽値を切り替える操作に目標状態が指定されておらず、ステータスフィールドもない場合、または形式や保存先などの未対応の条件が指定されている場合は、先に確認してください。
• インスタントリプレイまたはハイライトを有効にすると、無効にするまでバックグラウンドでキャプチャが続きます。どちらかを有効にする場合は、そのことを伝えてください。
• キャプチャを成功させるために Desktop Capture を有効にしてはなりません。対応しているゲーム以外のコンテンツは、このスキルの対象外です。

判断ルール

• このセッションの MCP カタログに nvapp_ ツールがない場合は、直接接続する前に nvidia-app の登録を試みてください。登録が拒否された場合、または失敗した場合は、再確認せずにセッションの残りの期間、HTTP または stdio による直接接続が可能です。
• どの接続方法を使用する場合も、同じツール名、スキーマ、アクセスレベル、Overlay の制限を守ってください。フォールバックで変更されるのはトランスポートのみであり、許可された操作範囲は変わりません。
• 録画、Instant Replay、Highlights、Statistics Overlay、または RTX Dynamic Vibrance の切り替えを実際に求められた場合は、nvapp_overlay_get_status を 1 回呼び出し、それぞれ recordingActive、instantReplayEnabled、highlightsEnabled、statsOverlayEnabled、または rtxDvc だけを反転してください。
• 必要なステータスフィールドがない場合は、推測せず、有効にするか無効にするかを確認してください。省略されたフィールドを false に変換してはいけません。
• nvapp_overlay_capture が受け取るのは 1 つのアクションであり、アクションのリストではありません。
• save_instant_replay または capture_screenshot に enable を追加してはいけません。
• toggle_recording、toggle_instant_replay、toggle_highlights、または nvapp_overlay_configure_stats から enable を省略してはいけません。
• nvapp_overlay_configure_filters には filter: "rtx_dvc" と enable の両方を渡してください。他のフィルター値を作り出してはいけません。
• 混在したリクエストでは、サポート対象の独立した操作を順番に実行し、サポートされていない操作について説明するか、スキップしてください。サポートされていない個別のリクエストが、必要な情報のそろったサポート対象の操作を妨げてはいけません。
• サポートされている状態変更操作にサポート対象外の条件が付いている場合は、制限を説明し、変更を実行する前に、サポート対象の範囲に限って進めてよいか確認してください。
• running: false は、現在のゲームが特定されていないことを意味します。gameName や processId を作り出してはいけません。fullscreen は返された場合にのみ報告してください。

出力形式

• ユーザーが指定した形式に従ってください。指定がない場合は、簡潔で読みやすい結果を返してください。
• 読み取りでは、存在する構造化フィールドのみを報告し、省略されたフィールドを false または null と区別してください。
• 失敗した場合は、操作が失敗したことを伝え、返されたエラーコード、再試行の可否、有用なガイダンスを保持してください。
• 認証情報を公開してはいけません。プロトコルレベルの詳細が必要な場合は、リクエストまたはレスポンスの形式のみを示し、トークン、認証ヘッダー、その他の秘密情報は <redacted-token> などのプレースホルダーに置き換えてください。

制限事項

• インストールされている NVIDIA App のバージョンやアクセスレベルによって、利用できる一般ツールや出力仕様は異なる場合があります。実際の tools/list が正式な情報源です。
• MCP の準備が整っていても、Overlay の準備が整っているとは限りません。また、変更成功のメッセージは、返された結果を超える内容を証明するものではありません。
• Overlay ワークフローでは、Desktop Capture や RTX Dynamic Vibrance 以外のフィルターの変更、スクリーンショット形式や保存先の選択、Statistics Overlay のレイアウトやスタイルの設定はできません。
• 欠落したフィールドは不明であり、暗黙の false 値ではありません。利用できないツールやバックエンドのタイムアウトを、推測したデータで補ってはいけません。

例

ドライバーの状態を確認する

「NVIDIA ドライバーの状態を表示して」などのリクエストでは、まず現在の MCP クライアントが nvapp_ ツールを公開しているか確認します。公開していない場合は、nvidia-app の登録を提案します。ユーザーが断った場合、または登録できない場合は、ループバックエンドポイントに直接接続し、そのことを伝えます。次に、その接続で tools/list を呼び出し、nvapp_client_get_driver_status が空のオブジェクト入力スキーマとともに公開されていることを確認します。利用できない場合は、接続先の NVIDIA App のバージョンまたはアクセスレベルではこのワークフローを利用できないと説明します。ライブスキーマを検証せずに、名前の似たツールで代用してはいけません。

呼び出し：

{
  "name": "nvapp_client_get_driver_status",
  "arguments": {}
}

返された構造化フィールドをそのまま使用します。

• systemType、installedDriver.version、任意項目の installedDriver.channel、および installedDriver.availableActions を報告します。
• preferredChannel を報告します。
• recommendedDrivers の各項目について、name、version、channel、releaseDate、isUpdateAvailable、および availableActions を報告します。
• previouslyInstalledDriver が null の場合は、NVIDIA App でロールバック用ドライバーが利用できないと報告します。それ以外の場合は、その name、version、releaseDate、および availableActions を報告します。

このツールは読み取り専用です。ドライバーを変更する操作は呼び出してはいけません。この7ツールの範囲には含まれていません。

明示的な目標状態で録画を開始する

要求された目標状態はすでに明確なため、変更操作を直接呼び出します。

{ "name": "nvapp_overlay_capture", "arguments": { "action": "toggle_recording", "enable": true } }

呼び出し前に状態を読み取ったり、呼び出し後に検証のための読み取りを行ったりしてはいけません。明示的な要求が承認に当たるため、追加の確認プロンプトは不要ですが、この呼び出しは画面のキャプチャを開始し、ファイルを書き込みます。返されたメッセージを報告し、キャプチャとプライバシーを参照してください。

目標状態が指定されていない場合に Instant Replay を切り替える

まず、{} を指定して nvapp_overlay_get_status を呼び出します。instantReplayEnabled が存在する場合は、その反対の値を enable に設定して nvapp_overlay_capture を1回呼び出します。このフィールドが存在しない場合は、Instant Replay を有効にするか無効にするかを尋ね、まだ変更操作は行いません。

サポートされていないスクリーンショット条件への対応

「D:\Shots に PNG スクリーンショットを撮って」と言われた場合、このツールでは形式や保存先を選択できないことを説明します。Overlay ギャラリーにキャプチャするかどうかを尋ねます。確認を得た後、次を呼び出します。

{ "name": "nvapp_overlay_capture", "arguments": { "action": "capture_screenshot" } }

トラブルシューティング

エラーまたは症状	考えられる原因	対応
service_disabled	MCP サーバーへの継続的なアクセスが無効になっている	NVIDIA App の設定で MCP サーバーへのアクセスを有効にするようユーザーに依頼します。ブリッジを繰り返し起動してはいけません。
overlay_not_available	MCP は接続されていますが、In-Game Overlay の準備ができていない	In-Game Overlay を有効にするか起動するようユーザーに依頼し、再試行は要求された場合に限ります。
overlay_timeout	Overlay が期限内に応答しなかった	retriable を保持します。結果が再試行を許可し、再試行がリクエストの範囲内に収まる場合は、最大1回だけ再試行します。その後、失敗を報告し、再度試す前に確認を求めます。
access_level_restricted	現在の MCP アクセス上限によりツールがブロックされている	制限を報告します。暗黙にアクセスレベルを引き上げてはいけません。
isError: true またはその他のバックエンド／検証エラー	要求された操作が成功しなかった	メッセージとエラーコードを保持します。データを推測したり、成功したと報告したりしてはいけません。

Overlay の変更操作は、構造化された成功フィールドではなく、人が読めるメッセージを返します。そのメッセージをそのまま報告し、追加の状態を推測してはいけません。Instant Replay の保存時に無効であると報告された場合は、有効にする前に確認を求めます。キャプチャに Desktop Capture が必要な場合は、Desktop Capture を有効にせず、制限を報告します。

参考資料

• クライアントの設定、ポート、検出と認証、プロトコルのライフサイクル、準備状況、接続のトラブルシューティングについては、references/connection.md を参照してください。
• Overlay 以外の NVIDIA App 操作におけるライブ検出、スキーマの使用、ルーティング、結果の処理については、references/general-tools.md を参照してください。
• 録画、Instant Replay、Highlights、スクリーンショット、サポート対象外の限定子、アクセス、キャプチャエラーについては、references/overlay-capture.md を参照してください。
• ステータスのルーティング、真偽値の切り替え、Statistics Overlay の表示、RTX Dynamic Vibrance、現在のゲームの検索については、references/overlay-state.md を参照してください。
• 正規のステータスフィールド一式、および正確な Overlay スキーマ、出力、アクセス階層、エラー形式が必要な場合については、references/mcp-tool-contract.md を参照してください。