MCP Reference: developerknowledge.googleapis.com

Un servidor de Protocolo de contexto del modelo (MCP) actúa como un proxy entre un servicio externo que proporciona contexto, datos o capacidades a un modelo de lenguaje grande (LLM) o una aplicación de IA. Los servidores de MCP conectan las aplicaciones de IA a sistemas externos, como bases de datos y servicios web, y traducen sus respuestas a un formato que la aplicación de IA pueda entender.

Configuración del servidor

Debes habilitar los servidores de MCP y configurar la autenticación antes de usarlos. Para obtener más información sobre el uso de los servidores de MCP remotos de Google y Google Cloud, consulta la descripción general de los servidores de MCP de Google Cloud.

Extremos del servidor

Un extremo de servicio de MCP es la dirección de red y la interfaz de comunicación (por lo general, una URL) del servidor de MCP que una aplicación de IA (el host del cliente de MCP) usa para establecer una conexión segura y estandarizada. Es el punto de contacto para que el LLM solicite contexto, llame a una herramienta o acceda a un recurso. Los extremos de MCP de Google pueden ser globales o regionales.

El servidor de MCP de la API de Developer Knowledge tiene el siguiente extremo de MCP global:

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

Herramientas de MCP

Una herramienta de MCP es una función o capacidad ejecutable que un servidor de MCP expone a un LLM o una aplicación de IA para realizar una acción en el mundo real.

Herramientas

El servidor de MCP developerknowledge.googleapis.com tiene las siguientes herramientas:

Herramientas de MCP
search_documents

Usa esta herramienta para encontrar documentación sobre los productos para desarrolladores de Google. Los documentos contienen APIs oficiales, fragmentos de código, notas de la versión, prácticas recomendadas, guías, información de depuración y mucho más. Abarca los siguientes productos y dominios:

  • 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 y 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

Esta herramienta devuelve fragmentos de texto, nombres y URIs de los documentos que coinciden. Prefiere search_documents seguido de get_documents cuando necesites muestras de código exactas, marcas de la CLI, mensajes de error específicos, guías de instructivos completas o búsqueda determinística de palabras clave. Si los fragmentos devueltos no son lo suficientemente detallados como para responder la pregunta del usuario, usa get_documents con el parent del resultado de esta herramienta para recuperar el contenido completo del documento. Cuando respondas al usuario, cita siempre los nombres de los recursos de los documentos de origen autorizados (documents/...) o los URIs.

answer_query

Usa answer_query para obtener una respuesta conceptual sintetizada y fundamentada a una pregunta de alto nivel sobre los productos de Google Developers. Para obtener muestras de código exactas, marcas de la CLI, mensajes de error específicos o explicaciones completas de documentos, prefiere search_documents seguido de get_documents. Esta herramienta tiene una cuota limitada. Esta herramienta sintetizará la información del corpus para generar una respuesta a la consulta. answer_query fundamenta las respuestas con el mismo corpus que search_documents. Esta herramienta devuelve el answer_text generado y una lista de nombres de documentos (referencias) que se usaron para generar la respuesta. Siempre cita los nombres de los documentos de origen autorizados de references (documents/...) en tu respuesta final al usuario. Usa get_documents con los nombres de los documentos de references para recuperar todo el contenido del documento si es necesario.

Si recibes un error 429 de cuota excedida, usa search_documents en su lugar.

get_documents Usa esta herramienta para recuperar el contenido completo de un solo documento o de hasta 20 documentos en una sola llamada. Los nombres de los documentos se deben obtener del campo parent de los resultados de una llamada a la herramienta search_documents o del campo references que devuelve la herramienta answer_query. Establece el parámetro names en una lista de nombres de documentos (documents/...) y cita los documentos de origen autorizados que se usaron en tu respuesta final.

Obtén las especificaciones de la herramienta de MCP

Para obtener las especificaciones de todas las herramientas de un servidor de MCP, usa el método tools/list. En el siguiente ejemplo, se muestra cómo usar curl para enumerar todas las herramientas y sus especificaciones disponibles actualmente en el servidor de MCP.

Solicitud de 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
}'