Overlay NVIDIA App MCP

Objectif

Utilisez cette compétence pour une intégration de produit : exploiter NVIDIA App via son serveur MCP local. Elle dispose de deux modes routés :

• Les opérations générales NVIDIA App couvrent le listage et le lancement d'applications, l'état des pilotes et les notes de version, l'optimisation par jeu et les fonctionnalités d'ordinateur portable.
• Les opérations Overlay en jeu utilisent le flux de travail ci-dessous.

Le flux de travail Overlay supporte :

• Lire le statut Overlay de haut niveau.
• Démarrer ou arrêter l'enregistrement de gameplay.
• Activer, désactiver ou enregistrer la Lecture instantanée.
• Activer ou désactiver les Points forts.
• Capturer une capture d'écran vers la galerie Overlay.
• Afficher ou masquer l'Overlay de statistiques.
• Activer ou désactiver le filtre RTX Dynamic Vibrance.
• Identifier le jeu actuellement exécuté.

La configuration de connexion supporte les deux modes mais n'autorise pas d'actions supplémentaires.

Quand utiliser cette compétence

Utilisez cette compétence lorsque l'utilisateur demande l'un des flux de travail d'application, de pilote, d'optimisation de jeu, de fonctionnalité d'ordinateur portable, d'Overlay ou de diagnostic de connexion supportés.

Ne sélectionnez pas cette compétence pour Capture du bureau, d'autres mutations de filtre Overlay, NVIDIA Broadcast, OBS, Xbox Game Bar ou autres logiciels de capture.

Entrées

• Requis : Une demande utilisateur pour une requête NVIDIA App supportée, une mutation ou un diagnostic de connexion.
• Optionnel : Un état cible explicite, un identifiant de jeu ou de programme, des valeurs spécifiques à l'outil et des détails de connexion client. Obtenez les jetons d'authentification uniquement à partir de la source de découverte protégée décrite dans references/connection.md ; n'acceptez jamais ou n'exposez pas les jetons comme arguments d'outil ordinaires.

Résolvez les informations dans cet ordre : instructions utilisateur explicites, schéma MCP en direct frais ou état, configuration de connexion client actuelle, puis la référence de compétence autonome applicable pour les détails de contrat statiques. Ne traitez jamais un résultat d'outil précédent comme l'état actuel.

Prérequis

• Hôte Windows avec NVIDIA App installé (version 11.0.9.5xx ou ultérieure) et son plugin MCP hébergé par NvContainer en cours d'exécution.
• Chemin d'exécution standard NVIDIA App : %ProgramFiles%\NVIDIA Corporation\NVIDIA App\CEF\NVIDIA App.exe.
• L'accès au serveur MCP est activé lorsque NVIDIA App expose un bouton bascule maître.
• NVIDIA In-Game Overlay est activé, en cours d'exécution et prêt avant tout appel nvapp_overlay_.
• Le client MCP supporte Streamable HTTP en loopback ou se connecte via le pont stdio installé.

La disponibilité du serveur MCP et la disponibilité d'Overlay sont séparées. Une connexion MCP réussie n'établit pas que les outils Overlay sont prêts.

Instructions

1. Classifiez la requête. Routez les demandes NVIDIA App générales via la découverte d'outil en direct. Routez les demandes nvapp_overlay_ via le flux de travail Overlay. Le statut Overlay en lecture seule peut inclure des champs pour les fonctionnalités exclues, mais cela n'autorise pas à les modifier.
2. Enregistrez nvidia-app dans le client MCP actuel ou échouez explicitement. Le client n'est enregistré que lorsque le catalogue d'outils en direct de cette session annonce les outils nvapp_ ; un port loopback ouvert ou un pont stdio fonctionnant n'est pas une enregistrement. Si ces outils sont absents, tentez l'enregistrement par references/connection.md avant le premier appel nvapp_. L'enregistrement est le chemin par défaut car il persiste entre les tours et sessions. Un point de terminaison HTTP accessible n'est pas une raison pour ignorer la tentative.
3. Utilisez la connexion directe uniquement comme secours déclaré. Si l'utilisateur refuse le changement de configuration, le client ne peut pas être modifié ou rechargé, ou l'enregistrement réussit mais les outils nvapp_ n'apparaissent toujours pas dans cette session, connectez-vous directement au point de terminaison HTTP loopback (ou au pont stdio) et continuez avec les mêmes contrats d'outil documentés. Dites quel chemin vous avez utilisé et que l'enregistrement de nvidia-app rendrait l'accès persistant. Ne préférez pas silencieusement le chemin direct.
4. Découvrez les outils généraux. Pour une demande non-Overlay, inspectez tools/list sur la connexion que vous avez établie, puis lisez references/general-tools.md avant de sélectionner ou d'appeler l'un de ses sept outils publics documentés. Sélectionnez uniquement un outil retourné dont la description, le schéma et les annotations correspondent le plus étroitement à l'intention de l'utilisateur dans la portée, et suivez tout schéma en direct et annotations plus étroites.
5. Résolvez un état cible Overlay. Pour une demande de démarrage, arrêt, activation, désactivation, affichage ou masquage explicite, appelez la mutation mappée directement. Pour un vrai basculement sans état cible, lisez le statut une fois et inversez uniquement le booléen correspondant.
6. Validez les arguments. Pour les outils généraux, suivez references/general-tools.md et tout schéma en direct plus étroit. Pour les outils Overlay, utilisez exactement les champs mappés ci-dessous. N'inventez jamais d'arguments non supportés.
7. Exécutez dans l'ordre de la requête. Remplissez les demandes composées en émettant chaque opération supportée comme son propre appel d'outil dans l'ordre de l'utilisateur. Faites uniquement les appels nécessaires pour les opérations demandées. Respectez le niveau d'accès et toute décision de consentement ; ne relevez jamais l'accès ou n'activez pas d'autre fonctionnalité comme contournement.
8. Interprétez le résultat littéralement. Rapportez uniquement les champs et résultats retournés. Les mutations Overlay retournent un message lisible par l'humain ; rapportez ce message sans inventer de champs de succès structurés. Si un message de mutation est ambigu, déclarez que le résultat n'est pas indépendamment confirmé au lieu de faire un appel de statut Overlay de suivi solely pour le vérifier.

Connexion

Le point de terminaison HTTP par défaut est :

http://127.0.0.1:13508/mcp

Le pont stdio installé est :

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

L'exécutable stdio relaie vers le serveur persistant ; il ne démarre pas ou n'active pas ce serveur.

Opérations NVIDIA App générales

Lisez references/general-tools.md avant de sélectionner ou d'appeler un outil NVIDIA App général. Il contient les sept noms d'outil supportés, les arguments exacts, les énumérations, les schémas conditionnels et les vérifications de prérequis.

Utilisez uniquement un outil documenté annoncé par tools/list en direct. Les instructions packagées sont autonomes et ne dépendent pas de sources de schéma internes au repository.

Opérations Overlay

Utilisez uniquement les outils dans ce tableau et les arguments autorisés affichés ici :

N'invoquez jamais toggle_desktop_capture. Pour nvapp_overlay_configure_filters, utilisez uniquement la valeur de filtre rtx_dvc.

Capture et confidentialité

toggle_recording, toggle_instant_replay, save_instant_replay, toggle_highlights et capture_screenshot enregistrent le contenu de l'écran et écrivent des fichiers médias sur le système de l'utilisateur. Les enregistrements et captures d'écran persistent dans la galerie NVIDIA App Overlay jusqu'à ce que l'utilisateur les supprime, et cette compétence ne peut pas choisir leur format, résolution ou destination.

Traitez chacun d'eux comme une opération affectant la confidentialité :

• Une demande utilisateur explicite de démarrage, arrêt, enregistrement, activation ou capture est l'autorisation. Effectuez cet appel mappé unique sans invite de confirmation supplémentaire, puis rapportez le message retourné pour que l'utilisateur sache que la capture a commencé ou que le média a été écrit.
• N'initiez jamais une capture que l'utilisateur n'a pas demandée. Ne démarrez pas l'enregistrement comme effet secondaire d'une autre demande ou comme contournement d'une opération échouée.
• Demandez d'abord lorsque la demande est ambiguë, lorsqu'un vrai basculement n'a pas d'état cible et que le champ statut est manquant, ou lorsqu'un qualificateur non supporté tel qu'un format ou une destination s'applique.
• L'activation de la Lecture instantanée ou des Points forts laisse la capture de fond s'exécuter jusqu'à ce qu'elle soit désactivée. Dites-le lorsque vous activez l'un ou l'autre.
• N'activez pas Capture du bureau pour qu'une capture réussisse. Le contenu en dehors d'un jeu supporté reste hors de portée pour cette compétence.

Règles de décision

• Si le catalogue MCP de cette session n'a aucun outil nvapp_, tentez l'enregistrement de nvidia-app avant de vous connecter directement. Une fois l'enregistrement refusé ou échoué, une connexion HTTP directe ou stdio est autorisée pour le reste de la session sans la redemander.
• Quelle que soit la connexion que vous utilisez, respectez les mêmes noms d'outil, schémas, niveau d'accès et restrictions Overlay. Le secours change uniquement le transport, jamais la surface autorisée.
• Pour une véritable demande de basculement de l'enregistrement, de la Lecture instantanée, des Points forts, de l'Overlay de statistiques ou de RTX Dynamic Vibrance, appelez nvapp_overlay_get_status une fois et inversez uniquement recordingActive, instantReplayEnabled, highlightsEnabled, statsOverlayEnabled ou rtxDvc, respectivement.
• Si le champ statut requis est absent, demandez d'activer ou de désactiver au lieu de deviner. Ne convertissez jamais un champ omis en false.
• nvapp_overlay_capture accepte une action, pas une liste d'actions.
• N'ajoutez pas enable à save_instant_replay ou capture_screenshot.
• N'omettez pas enable de toggle_recording, toggle_instant_replay, toggle_highlights ou nvapp_overlay_configure_stats.
• Passez à la fois filter: "rtx_dvc" et enable à nvapp_overlay_configure_filters ; n'inventez jamais une autre valeur de filtre.
• Pour une demande mixte, exécutez les opérations supportées indépendantes dans l'ordre et expliquez ou ignorez les opérations non supportées ; une demande soeur non supportée ne doit pas bloquer une action supportée complètement spécifiée.
• Lorsqu'un qualificateur non supporté modifie une opération changeant d'état autrement supportée, expliquez la limitation et demandez si vous devez procéder avec ce sous-ensemble supporté avant d'effectuer son appel de mutation.
• running: false signifie qu'aucun jeu actuel n'a été identifié. N'inventez pas gameName ou processId. Rapportez fullscreen uniquement quand il est retourné.

Format de sortie

• Suivez le format demandé par l'utilisateur ; sinon, donnez un résultat concis lisible par l'humain.
• Pour les lectures, rapportez uniquement les champs structurés présents et distinguez un champ omis de false ou null.
• Pour les défaillances, déclarez que l'opération a échoué et préservez le code d'erreur retourné, la possibilité de relance et les conseils utiles.
• N'exposez jamais le matériel d'authentification. Lorsque le détail au niveau du protocole est nécessaire, affichez uniquement la forme de requête ou de réponse et remplacez les jetons, en-têtes d'autorisation et autres secrets par des placeholders tels que <redacted-token>.

Limitations

• Les versions installées de NVIDIA App et les niveaux d'accès peuvent exposer des outils généraux différents et des contrats de sortie ; tools/list en direct est autoritaire.
• La disponibilité MCP ne garantit pas la disponibilité d'Overlay, et un message de mutation réussi ne prouve pas plus que le résultat retourné.
• Le flux de travail Overlay ne peut pas muter la Capture du bureau ou les filtres autres que RTX Dynamic Vibrance, choisir le format ou la destination de capture d'écran, ou configurer la mise en page et le style de l'Overlay de statistiques.
• Les champs manquants sont inconnus, pas des valeurs implicites false, et les outils indisponibles ou les dépassements de délai du backend ne doivent pas être remplacés par des données déduites.

Exemples

Obtenir le statut du pilote

Pour une demande telle que « Afficher le statut de mon pilote NVIDIA », vérifiez d'abord si le client MCP actuel annonce les outils nvapp_. Si ce n'est pas le cas, proposez d'enregistrer nvidia-app ; si l'utilisateur décline ou que l'enregistrement n'est pas possible, connectez-vous directement au point de terminaison loopback et dites-le. Ensuite, appelez tools/list sur cette connexion et confirmez que nvapp_client_get_driver_status est annoncé avec un schéma d'entrée d'objet vide. S'il est indisponible, expliquez que la version ou le niveau d'accès connecté de NVIDIA App n'expose pas ce flux de travail ; ne substituez pas un outil au nom similaire sans valider son schéma en direct.

Invoquez :

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

Utilisez littéralement les champs structurés retournés :

• Rapportez systemType, installedDriver.version, installedDriver.channel optionnel et installedDriver.availableActions.
• Rapportez preferredChannel.
• Pour chaque élément dans recommendedDrivers, rapportez name, version, channel, releaseDate, isUpdateAvailable et availableActions.
• Si previouslyInstalledDriver est null, déclarez que NVIDIA App rapporte qu'aucun pilote de restauration n'est disponible. Sinon, rapportez son name, version, releaseDate et availableActions.

Cet outil est en lecture seule. N'invoquez pas de mutation de pilote ; aucune n'est incluse dans cette portée de sept outils.

Démarrer l'enregistrement avec un état cible explicite

Appelez la mutation directement car l'état cible demandé est déjà connu :

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

Ne lisez pas le statut avant l'appel ou n'émettez pas une vérification de lecture après. La demande explicite est l'autorisation, donc aucune invite de confirmation supplémentaire n'est nécessaire, mais cet appel démarre la capture d'écran et écrit un fichier ; rapportez le message retourné et consultez Capture et confidentialité.

Basculer la Lecture instantanée sans état cible

Appelez d'abord nvapp_overlay_get_status avec {}. Si instantReplayEnabled est présent, appelez nvapp_overlay_capture une fois avec enable défini à son opposé. Si le champ est absent, demandez si vous devez activer ou désactiver la Lecture instantanée et n'effectuez aucune mutation pour le moment.

Gérer un qualificateur de capture d'écran non supporté

Pour « Prendre une capture d'écran PNG dans D:\Shots », expliquez que l'outil ne peut pas sélectionner le format ou la destination. Demandez si vous devez capturer vers la galerie Overlay. Après confirmation, appelez :

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

Dépannage

Les mutations Overlay retournent un message lisible par l'humain plutôt que des champs de succès structurés. Rapportez ce message littéralement et ne déduisez pas d'état supplémentaire. Si l'enregistrement de la Lecture instantanée rapporte qu'elle est désactivée, demandez avant de l'activer. Si la capture nécessite Capture du bureau, rapportez la limitation plutôt que d'activer Capture du bureau.

Références

• Lisez references/connection.md pour la configuration du client, les ports, la découverte et l'authentification, le cycle de vie du protocole, la disponibilité et le dépannage des connexions.
• Lisez references/general-tools.md pour la découverte en direct, l'utilisation du schéma, le routage et la gestion des résultats pour les opérations NVIDIA App non-Overlay.
• Lisez references/overlay-capture.md pour l'enregistrement, la Lecture instantanée, les Points forts, les captures d'écran, les qualificateurs non supportés, l'accès et les erreurs de capture.
• Lisez references/overlay-state.md pour le routage des statuts, les vrais basculements, la visibilité de l'Overlay de statistiques, RTX Dynamic Vibrance et la recherche de jeu actuel.
• Lisez references/mcp-tool-contract.md pour l'ensemble de champs statut canonique et lorsque les schémas Overlay exacts, les sorties, les niveaux d'accès ou les formes d'erreur sont nécessaires.