MCP Reference: developerknowledge.googleapis.com

Un serveur MCP (Model Context Protocol) sert de proxy entre un service externe qui fournit du contexte, des données ou des capacités à un grand modèle de langage (LLM) ou à une application d'IA. Les serveurs MCP connectent les applications d'IA à des systèmes externes tels que des bases de données et des services Web, et traduisent leurs réponses dans un format que l'application d'IA peut comprendre.

Configuration du serveur

Vous devez activer les serveurs MCP et configurer l'authentification avant de les utiliser. Pour en savoir plus sur l'utilisation des serveurs MCP distants Google et Google Cloud, consultez la présentation des serveurs MCP Google Cloud.

Points de terminaison du serveur

Un point de terminaison de service MCP est l'adresse réseau et l'interface de communication (généralement une URL) du serveur MCP qu'une application d'IA (l'hôte du client MCP) utilise pour établir une connexion sécurisée et standardisée. Il s'agit du point de contact permettant au LLM de demander du contexte, d'appeler un outil ou d'accéder à une ressource. Les points de terminaison Google MCP peuvent être globaux ou régionaux.

Le serveur MCP de l'API Developer Knowledge dispose du point de terminaison MCP global suivant :

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

Outils MCP

Un outil MCP est une fonction ou une capacité exécutable qu'un serveur MCP expose à un LLM ou à une application d'IA pour effectuer une action dans le monde réel.

Outils

Le serveur MCP developerknowledge.googleapis.com dispose des outils suivants :

Outils MCP
search_documents

Utilisez cet outil pour trouver de la documentation sur les produits Google pour les développeurs. Les documents contiennent des API officielles, des extraits de code, des notes de version, des bonnes pratiques, des guides, des informations de débogage, etc. Il couvre les produits et domaines suivants :

  • 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

  • IA de Google : ai.google.dev

  • Google Antigravity : antigravity.google

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

  • Google Developers, Ads, Search, 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

Cet outil renvoie des fragments de texte, des noms et des URI pour les documents correspondants. Privilégiez search_documents suivi de get_documents lorsque vous avez besoin d'exemples de code exacts, d'options de CLI, de messages d'erreur spécifiques, de tutoriels complets ou d'une recherche déterministe par mot clé. Si les fragments renvoyés ne sont pas assez détaillés pour répondre à la question de l'utilisateur, utilisez get_documents avec l'parent de la sortie de cet outil pour récupérer l'intégralité du contenu du document. Lorsque vous répondez à l'utilisateur, indiquez toujours les noms de ressources (documents/...) ou les URI des documents sources faisant autorité.
answer_query

Utilisez answer_query pour obtenir une réponse conceptuelle synthétisée et ancrée à une question de haut niveau sur les produits Google Developers. Pour obtenir des exemples de code exacts, des options de CLI, des messages d'erreur spécifiques ou des tutoriels complets, privilégiez plutôt search_documents suivi de get_documents. Cet outil dispose d'un quota limité. Cet outil synthétise les informations du corpus pour générer une réponse à la requête. answer_query fonde les réponses sur le même corpus que search_documents. Cet outil renvoie le texte de la réponse générée (answer_text) et une liste de noms de documents (références) utilisés pour générer la réponse. Citez toujours les noms des documents sources faisant autorité de references (documents/...) dans votre réponse finale à l'utilisateur. Utilisez get_documents avec les noms de documents de references pour récupérer l'intégralité du contenu du document si nécessaire.

Si vous obtenez une erreur 429 de dépassement de quota, utilisez plutôt search_documents.
get_documents Utilisez cet outil pour récupérer l'intégralité du contenu d'un seul document ou de 20 documents maximum en un seul appel. Les noms des documents doivent être obtenus à partir du champ parent des résultats d'un appel à l'outil search_documents ou du champ references renvoyé par l'outil answer_query. Définissez le paramètre names sur une liste de noms de documents (documents/...) et citez les documents sources faisant autorité utilisés dans votre réponse finale.

Obtenir les spécifications de l'outil MCP

Pour obtenir les spécifications des outils MCP pour tous les outils d'un serveur MCP, utilisez la méthode tools/list. L'exemple suivant montre comment utiliser curl pour lister tous les outils et leurs spécifications actuellement disponibles sur le serveur MCP.

Requête curl 
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
}'