MCP Reference: developerknowledge.googleapis.com

Ein MCP-Server (Model Context Protocol) fungiert als Proxy zwischen einem externen Dienst, der einem Large Language Model (LLM) oder einer KI-Anwendung Kontext, Daten oder Funktionen bereitstellt. MCP-Server verbinden KI-Anwendungen mit externen Systemen wie Datenbanken und Webdiensten und übersetzen deren Antworten in ein Format, das die KI-Anwendung versteht.

Server einrichten

Sie müssen MCP-Server aktivieren und die Authentifizierung einrichten, bevor Sie sie verwenden können. Weitere Informationen zur Verwendung von Remote-MCP-Servern von Google und Google Cloud finden Sie unter Google Cloud-MCP-Server – Übersicht.

Serverendpunkte

Ein MCP-Dienstendpunkt ist die Netzwerkadresse und Kommunikationsschnittstelle (normalerweise eine URL) des MCP-Servers, die eine KI-Anwendung (der Host für den MCP-Client) verwendet, um eine sichere, standardisierte Verbindung herzustellen. Er ist der Kontaktpunkt für das LLM, um Kontext anzufordern, ein Tool aufzurufen oder auf eine Ressource zuzugreifen. Google MCP-Endpunkte können global oder regional sein.

Der MCP-Server der Developer Knowledge API hat den folgenden globalen MCP-Endpunkt:

  • https://developerknowledge.googleapis.com/mcp

MCP-Tools

Ein MCP-Tool ist eine Funktion oder ausführbare Fähigkeit, die ein MCP-Server einem LLM oder einer KI-Anwendung zur Verfügung stellt, um eine Aktion in der realen Welt auszuführen.

Tools

Der MCP-Server developerknowledge.googleapis.com bietet die folgenden Tools:

MCP-Tools
search_documents

Mit diesem Tool können Sie Dokumentation zu Google-Entwicklerprodukten finden. Die Dokumente enthalten offizielle APIs, Code-Snippets, Versionshinweise, Best Practices, Leitfäden, Informationen zur Fehlerbehebung und mehr. Folgende Produkte und Domains werden abgedeckt:

  • ADK: adk.dev

  • Android: developer.android.com

  • Apigee: docs.apigee.com

  • Chrome: developer.chrome.com

  • Dart: dart.dev

  • Firebase: firebase.google.com

  • Flutter: docs.flutter.dev

  • Fuchsia: fuchsia.dev

  • Gemini CLI: geminicli.com

  • Genkit: genkit.dev

  • Go: go.dev

  • Google AI: ai.google.dev

  • Google Antigravity: antigravity.google

  • Google Cloud: cloud.google.com und docs.cloud.google.com

  • Google Developers, Ads, Suche, Google Maps, YouTube: developers.google.com

  • Google Home: developers.home.google.com

  • Google Maps Platform: mapsplatform.google.com

  • Google Workspace: knowledge.workspace.google.com

  • TensorFlow: www.tensorflow.org

  • Web: web.dev

Dieses Tool gibt Textblöcke, Namen und URIs für übereinstimmende Dokumente zurück. Verwenden Sie search_documents gefolgt von get_documents, wenn Sie genaue Codebeispiele, CLI-Flags, bestimmte Fehlermeldungen, vollständige Anleitungen oder eine deterministische Keyword-Suche benötigen. Wenn die zurückgegebenen Chunks nicht detailliert genug sind, um die Frage des Nutzers zu beantworten, verwenden Sie get_documents mit der parent aus der Ausgabe dieses Tools, um den vollständigen Dokumentinhalt abzurufen. Geben Sie bei der Beantwortung der Nutzerfrage immer die Ressourcennamen (documents/...) oder URIs des maßgeblichen Quelldokuments an.
answer_query

Verwenden Sie „answer_query“, um eine fundierte, zusammengefasste konzeptionelle Antwort auf eine allgemeine Frage zu Google Developers-Produkten zu erhalten. Für genaue Codebeispiele, CLI-Flags, spezifische Fehlermeldungen oder vollständige Dokumentanleitungen sollten Sie stattdessen search_documents gefolgt von get_documents verwenden. Dieses Tool hat ein begrenztes Kontingent. Dieses Tool fasst Informationen aus dem Korpus zusammen, um eine Antwort auf die Anfrage zu generieren. „answer_query“ fundiert Antworten mit demselben Korpus wie „search_documents“. Dieses Tool gibt den generierten „answer_text“ und eine Liste der Dokumentnamen (Referenzen) zurück, die zum Generieren der Antwort verwendet wurden. Nenne in deiner endgültigen Antwort an den Nutzer immer die Namen der maßgeblichen Quelldokumente aus references (documents/...). Verwenden Sie get_documents mit den Dokumentnamen aus references, um bei Bedarf den gesamten Dokumentinhalt abzurufen.

Wenn Sie den Fehler „429 – Kontingent überschritten“ erhalten, verwenden Sie stattdessen „search_documents“.
get_documents Mit diesem Tool können Sie den vollständigen Inhalt eines einzelnen Dokuments oder von bis zu 20 Dokumenten in einem einzigen Aufruf abrufen. Die Dokumentnamen sollten entweder aus dem Feld parent der Ergebnisse eines Aufrufs des search_documents-Tools oder aus dem Feld references stammen, das vom answer_query-Tool zurückgegeben wird. Legen Sie den Parameter names auf eine Liste von Dokumentnamen (documents/...) fest und zitieren Sie die maßgeblichen Quelldokumente, die in Ihrer endgültigen Antwort verwendet wurden.

Spezifikationen für MCP-Tools abrufen

Mit der Methode tools/list können Sie die MCP-Toolspezifikationen für alle Tools auf einem MCP-Server abrufen. Im folgenden Beispiel wird gezeigt, wie Sie mit curl alle Tools und ihre Spezifikationen auflisten, die derzeit auf dem MCP-Server verfügbar sind.

Curl-Anfrage 
curl --location 'https://developerknowledge.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'