query_library_get

Ruft einen Eintrag der Query Library anhand einer von query_library_search zurückgegebenen id ab.

Wenn params fehlt oder leer ist, gibt es die Rohvorlage, die Parameterdeklarationen und die Anmerkungen zurück. Bei einem nicht leeren params-Objekt validiert der Server die Werte und setzt sie in die Vorlage ein. SQL wird nur zurückgegeben, wenn das Rendering erfolgreich ist. Das Modell muss die Werte nicht selbst einsetzen.

Dieses Tool führt kein SQL aus und prüft keine Cloud-Anmeldedaten. Seine Parametervalidierung unterscheidet sich von validate_select_query, das ein SELECT gegen den installierten Provider parst und plant.

Siehe auch: [ MCP-Übersicht ] [ query_library_search ] [ run_select_query ] [ run_mutation_query ] [ run_lifecycle_operation ]

---

Eingaben

Argument	Erforderlich	Beschreibung
id	Ja	Abfrage-ID aus den Suchergebnissen, zum Beispiel aws/s3/buckets-list.
params	Nein	Objekt, das deklarierte Parameternamen auf Werte abbildet. Lassen Sie es weg oder übergeben Sie {}, um die Vorlage ohne Rendering zu inspizieren.
format	Nein	Textrendering: markdown oder json. Wenn nicht angegeben, wird die Rendering-Einstellung des Servers verwendet (standardmäßig markdown).

Unbekannte Parameter werden abgelehnt. Erforderliche Parameter ohne übergebene Werte oder Standardwerte werden in missing_params gemeldet. Übergebene Werte werden gegen die deklarierten Typen und Einschränkungen geprüft; nicht aufgelöste Platzhalter sind Fehler.

---

Ausgabe

Die Standard-Textansicht ist ein KV-Block mit Identität, Mutationsstatus, dem nächsten Tool, Gültigkeit, Quell-Links sowie etwaiger Vorlage, gerendertem SQL oder Fehlern. Verwenden Sie die strukturierte Payload oder format: "json" für die vollständigen Metadaten:

Feld	Beschreibung
id, title, description	Identität und Zusammenfassung des Eintrags.
mutation, verb	Ob der Eintrag Ressourcen ändert und, sofern deklariert, sein Operationstyp (select, mutation oder lifecycle).
next_tool	Ausführungstool für den Eintrag: run_select_query, run_mutation_query oder run_lifecycle_operation. Der Abruf ruft es nicht auf.
params	Parameterdeklarationen mit Namen, Typen, Pflichtkennzeichen sowie etwaigen Standardwerten, Beschreibungen, Beispielen, Enums oder Mustern.
template, notes	Rohvorlage und Anmerkungen des Autors, zurückgegeben, wenn params fehlt oder leer ist.
rendered, valid	Ob das Rendering versucht wurde und erfolgreich war. Beide sind false, wenn die Rohvorlage inspiziert wird.
sql	Gerendertes SQL, nur nach erfolgreichem Rendering vorhanden.
missing_params, unknown_params, errors	Validierungsdetails, wenn das Rendering fehlschlägt. Führen Sie kein SQL aus, bis diese behoben sind.
auth, permissions	Sofern deklariert, die für die Ausführung benötigten Umgebungsvariablen für Anmeldedaten und providereigenen Berechtigungen. Der Abruf selbst benötigt keines von beiden.
cost, outputs, related	Sofern deklariert, Hinweise zu Fan-out und Kosten, Beschreibungen der Ergebnisspalten und IDs verwandter Einträge.
doc_url	Für Menschen lesbare Seite der Query Library.
source_tier, source_url, stale	Herkunft des Inhalts: primary, fallback oder snapshot, dessen URL oder eingebetteter Pfad sowie ob der Inhalt nach einem fehlgeschlagenen Abruf aus dem Cache oder Snapshot bereitgestellt wurde.

Eine unbekannte oder fehlerhafte ID liefert einen Fehler. Verwenden Sie query_library_search, um gültige IDs zu finden.

---

Freigabe

In jedem Servermodus erlaubt, vorbehaltlich der konfigurierten Tool-Allowlist. Das Abrufen oder Rendern einer Mutations- oder Lebenszyklusvorlage hat keine cloudseitige Wirkung und benötigt keine Genehmigung. Das Ausführen des zurückgegebenen SQL ist ein separater Aufruf, der dem Modus des Servers unterliegt.

---

Beispiel

Inspizieren Sie zunächst einen Eintrag:

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

Übergeben Sie dann die erforderliche Routing-Region:

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

Nachdem Sie rendered und valid geprüft haben, validieren Sie das zurückgegebene SELECT mit validate_select_query. Führen Sie es mit dem in next_tool genannten Tool aus, übergeben Sie dabei das zurückgegebene sql und setzen Sie source zur Attribution auf die id des Query-Library-Eintrags. Zur Ausführungszeit sind Provider-Anmeldedaten und -Berechtigungen erforderlich.