Dokumentations-Lookup

Dokumentations-Lookup (Context7)

Wenn der Benutzer nach Bibliotheken, Frameworks oder APIs fragt, rufe die aktuelle Dokumentation über den Context7 MCP ab (Werkzeuge resolve-library-id und query-docs), anstatt dich auf Trainingsdaten zu verlassen.

Kernkonzepte

• Context7: MCP-Server, der Live-Dokumentation bereitstellt; verwende ihn anstelle von Trainingsdaten für Bibliotheken und APIs.
• resolve-library-id: Gibt Context7-kompatible Bibliotheks-IDs zurück (z. B. /vercel/next.js) aus einem Bibliotheksnamen und einer Abfrage.
• query-docs: Ruft Dokumentation und Code-Snippets für eine bestimmte Bibliotheks-ID und Frage ab. Rufe immer zuerst resolve-library-id auf, um eine gültige Bibliotheks-ID zu erhalten.

Wann verwenden

Aktiviere diese Fähigkeit, wenn der Benutzer:

• Setup- oder Konfigurationsfragen stellt (z. B. „Wie konfiguriere ich Next.js Middleware?“)
• Code anfordert, der von einer Bibliothek abhängt („Schreibe eine Prisma-Abfrage für …“)
• API- oder Referenzinformationen benötigt („Welche Supabase-Auth-Methoden gibt es?“)
• Bestimmte Frameworks oder Bibliotheken erwähnt (React, Vue, Svelte, Express, Tailwind, Prisma, Supabase usw.)

Verwende diese Fähigkeit immer dann, wenn die Anfrage von korrektem, aktuellem Verhalten einer Bibliothek, eines Frameworks oder einer API abhängt. Gilt für alle Umgebungen, die den Context7 MCP konfiguriert haben (z. B. Claude Code, Cursor, Codex).

So funktioniert es

Schritt 1: Bibliotheks-ID auflösen

Rufe das MCP-Werkzeug resolve-library-id auf mit:

• libraryName: Der Name der Bibliothek oder des Produkts aus der Frage des Benutzers (z. B. Next.js, Prisma, Supabase).
• query: Die vollständige Frage des Benutzers. Dies verbessert die Relevanz der Ergebnisse.

Du musst eine Context7-kompatible Bibliotheks-ID erhalten (Format /org/projekt oder /org/projekt/version), bevor du die Doku abfragst. Rufe query-docs nicht ohne eine gültige Bibliotheks-ID aus diesem Schritt auf.

Schritt 2: Besten Treffer auswählen

Wähle aus den Auflösungsergebnissen ein Ergebnis aus, indem du Folgendes bewertest:

• Namensübereinstimmung: Bevorzuge die exakte oder ähnlichste Übereinstimmung mit dem, wonach der Benutzer gefragt hat.
• Benchmark-Score: Höhere Werte bedeuten eine bessere Dokumentationsqualität (100 ist der höchste Wert).
• Quellreputation: Bevorzuge, falls verfügbar, eine hohe oder mittlere Reputation.
• Version: Wenn der Benutzer eine Version genannt hat (z. B. „React 19“, „Next.js 15“), bevorzuge eine versionsspezifische Bibliotheks-ID, falls aufgelistet (z. B. /org/projekt/v1.2.0).

Schritt 3: Dokumentation abrufen

Rufe das MCP-Werkzeug query-docs auf mit:

• libraryId: Die ausgewählte Context7-Bibliotheks-ID aus Schritt 2 (z. B. /vercel/next.js).
• query: Die spezifische Frage oder Aufgabe des Benutzers. Formuliere sie präzise, um relevante Snippets zu erhalten.

Begrenzung: Rufe query-docs (oder resolve-library-id) nicht mehr als 3 Mal pro Frage auf. Falls die Antwort nach 3 Aufrufen unklar bleibt, gib die Unsicherheit an und verwende die besten verfügbaren Informationen, anstatt zu raten.

Schritt 4: Dokumentation verwenden

• Beantworte die Frage des Benutzers mit den abgerufenen, aktuellen Informationen.
• Füge bei Bedarf relevante Codebeispiele aus der Dokumentation hinzu.
• Nenne die Bibliothek oder Version, wenn es relevant ist (z. B. „In Next.js 15 …“).

Beispiele

Beispiel: Next.js Middleware

1. Rufe resolve-library-id auf mit libraryName: "Next.js", query: "Wie richte ich Next.js Middleware ein?".
2. Wähle aus den Ergebnissen den besten Treffer (z. B. /vercel/next.js) nach Name und Benchmark-Score aus.
3. Rufe query-docs auf mit libraryId: "/vercel/next.js", query: "Wie richte ich Next.js Middleware ein?".
4. Verwende die zurückgegebenen Snippets und Texte zur Beantwortung; füge bei Bedarf ein minimales middleware.ts-Beispiel aus der Doku hinzu.

Beispiel: Prisma-Abfrage

1. Rufe resolve-library-id auf mit libraryName: "Prisma", query: "Wie führe ich eine Abfrage mit Relationen durch?".
2. Wähle die offizielle Prisma-Bibliotheks-ID (z. B. /prisma/prisma).
3. Rufe query-docs auf mit dieser libraryId und der Abfrage.
4. Gib das Prisma-Client-Muster (z. B. include oder select) mit einem kurzen Code-Snippet aus der Doku zurück.

Beispiel: Supabase Auth-Methoden

1. Rufe resolve-library-id auf mit libraryName: "Supabase", query: "Welche Auth-Methoden gibt es?".
2. Wähle die Supabase-Dokumentations-Bibliotheks-ID.
3. Rufe query-docs auf; fasse die Auth-Methoden zusammen und zeige minimale Beispiele aus der abgerufenen Doku.

Best Practices

• Sei präzise: Verwende nach Möglichkeit die vollständige Frage des Benutzers als Abfrage für bessere Relevanz.
• Versionsbewusstsein: Wenn Benutzer Versionen nennen, verwende versionsspezifische Bibliotheks-IDs aus dem Auflösungsschritt, falls verfügbar.
• Bevorzuge offizielle Quellen: Wenn mehrere Treffer existieren, bevorzuge offizielle oder primäre Pakete gegenüber Community-Forks.
• Keine sensiblen Daten: Entferne API-Schlüssel, Passwörter, Tokens und andere Geheimnisse aus allen an Context7 gesendeten Abfragen. Behandle die Frage des Benutzers als potenziell geheimnisbehaftet, bevor du sie an resolve-library-id oder query-docs übergibst.