query_library_get

Récupère une entrée de la Query Library à partir d'un id renvoyé par query_library_search.

Lorsque params est omis ou vide, il renvoie le modèle brut, les déclarations de paramètres et les notes. Avec un objet params non vide, le serveur valide les valeurs et les substitue dans le modèle. Il ne renvoie du SQL que si le rendu réussit. Le modèle de langage n'a pas besoin de substituer lui-même les valeurs.

Cet outil n'exécute pas de SQL et ne vérifie pas les identifiants cloud. Sa validation des paramètres est distincte de validate_select_query, qui analyse et planifie un SELECT sur le provider installé.

Voir aussi : [ Présentation de MCP ] [ query_library_search ] [ run_select_query ] [ run_mutation_query ] [ run_lifecycle_operation ]

---

Entrées

Argument	Obligatoire	Description
id	Oui	ID de requête issu des résultats de recherche, par exemple aws/s3/buckets-list.
params	Non	Objet associant les noms des paramètres déclarés à des valeurs. Omettez-le ou passez {} pour inspecter le modèle sans rendu.
format	Non	Rendu du texte : markdown ou json. S'il est omis, le paramètre de rendu du serveur est utilisé (markdown par défaut).

Les paramètres inconnus sont rejetés. Les paramètres obligatoires sans valeur fournie ni valeur par défaut sont signalés dans missing_params. Les valeurs fournies sont vérifiées par rapport aux types et aux contraintes déclarés ; les espaces réservés non résolus sont des erreurs.

---

Sortie

La vue texte par défaut est un bloc KV avec l'identité, le statut de mutation, l'outil suivant, la validité, les liens vers la source et, le cas échéant, le modèle, le SQL rendu ou les erreurs. Utilisez la charge utile structurée ou format: "json" pour obtenir les métadonnées complètes :

Champ	Description
id, title, description	Identité et résumé de l'entrée.
mutation, verb	Indique si l'entrée modifie des ressources et, lorsqu'il est déclaré, son type d'opération (select, mutation ou lifecycle).
next_tool	Outil d'exécution de l'entrée : run_select_query, run_mutation_query ou run_lifecycle_operation. La récupération ne l'appelle pas.
params	Déclarations de paramètres avec les noms, les types, le caractère obligatoire et, le cas échéant, les valeurs par défaut, descriptions, exemples, énumérations ou motifs.
template, notes	Modèle brut et notes de l'auteur, renvoyés lorsque params est omis ou vide.
rendered, valid	Indiquent si le rendu a été tenté et s'il a réussi. Les deux valent false lors de l'inspection du modèle brut.
sql	SQL rendu, présent uniquement après un rendu réussi.
missing_params, unknown_params, errors	Détails de validation lorsque le rendu échoue. N'exécutez pas le SQL tant que ces points ne sont pas résolus.
auth, permissions	Lorsqu'elles sont déclarées, les variables d'environnement d'identifiants et les permissions natives du provider nécessaires à l'exécution. La récupération elle-même ne requiert ni les unes ni les autres.
cost, outputs, related	Lorsqu'ils sont déclarés, les indications de fan-out et de coût, les descriptions des colonnes de résultat et les ID des entrées associées.
doc_url	Page de la Query Library lisible par un humain.
source_tier, source_url, stale	Provenance du contenu : primary, fallback ou snapshot, son URL ou son chemin embarqué, et si le contenu a été servi depuis le cache ou l'instantané après un échec de récupération.

Un ID inconnu ou mal formé renvoie une erreur. Utilisez query_library_search pour trouver des ID valides.

---

Contrôle

Autorisé dans tous les modes du serveur, sous réserve de la liste d'autorisation d'outils configurée. La récupération ou le rendu d'un modèle de mutation ou de cycle de vie n'a aucun effet côté cloud et ne nécessite aucune approbation. L'exécution du SQL renvoyé est un appel distinct, régi par le mode du serveur.

---

Exemple

Inspectez d'abord une entrée :

{
  "id": "aws/s3/buckets-list"
}

Fournissez ensuite sa région de routage obligatoire :

{
  "id": "aws/s3/buckets-list",
  "params": {
    "region": "us-east-1"
  }
}

Après avoir vérifié rendered et valid, validez le SELECT renvoyé avec validate_select_query. Exécutez-le avec l'outil indiqué dans next_tool, en passant le sql renvoyé et en définissant source sur l'id de l'entrée de la Query Library à des fins d'attribution. Les identifiants et les permissions du provider sont requis au moment de l'exécution.