Protocolo de Contexto del Modelo en ADK-Rust

El Protocolo de Contexto del Modelo (MCP) es el límite entre una aplicación de IA y una capacidad administrada por separado. Un servidor MCP puede publicar herramientas, recursos legibles, plantillas de indicaciones y completado de argumentos. El cliente descubre ese catálogo y se comunica mediante métodos de protocolo negociados en lugar de una integración privada.

ADK-Rust 2 utiliza el SDK oficial de rmcp 3.1. El cliente negocia MCP 2025-11-25 de forma predeterminada y llega a servidores 2026-07-28 mediante su protocolo de enlace heredado. Consulta compatibilidad con rmcp.

Dónde encaja ADK-Rust

Rendering architecture…

McpToolset adapta una conexión de cliente MCP inicializada a ADK-Rust. McpServerManager administra un registro cambiante de procesos secundarios locales de stdio y agrega sus herramientas. Las aplicaciones que publican capacidades pueden crear servidores MCP con adk_tool::mcp::rmcp, que es la versión exacta de SDK utilizada por el framework.

Elige la interfaz adecuada

NecesitasUsaPropiedad
Conectar un servidor local conocidoMcpToolset + TokioChildProcessLa aplicación inicia el proceso secundario
Conectar un servicio MCP remotoMcpHttpClientBuilderLa implementación remota garantiza la disponibilidad
Cambiar las definiciones del servidor local en tiempo de ejecuciónMcpServerManagerLa aplicación posee un registro local y procesos secundarios
Publicar un servidor MCPadk_tool::mcp::rmcpTu servicio posee esquemas, autorización y efectos secundarios
Mantener operativa una integración de muestreo obsoletamcp-sampling característicaSolo compatibilidad con SEP-2577

Mapa de capacidades implementadas

CapacidadADK-Rust APIComportamiento
Descubrimiento y llamadas de herramientasMcpToolset, ToolsetLos esquemas sin procesar y los resultados multimodales se conservan
Filtrado de herramientaswith_filter, with_toolsEl modelo solo ve las herramientas seleccionadas
Recursos y plantillaslist_resources, list_resource_templates, read_resourceLeer el contexto mediante URIs estable
Indicacioneslist_prompts, get_promptResolver mensajes reutilizables administrados por el servidor
Finalizacióncomplete_prompt_argument, complete_resource_argumentSolicitar al servidor sugerencias de argumentos
Suscripciones a recursossubscribe_resource, unsubscribe_resourceLos controladores personalizados reciben notificaciones de actualización
Recopilación de informaciónElicitationHandlerModos de formulario y URL
TareasMcpTaskConfigCreación, sondeo, resultados y cancelación de tareas de llamadas a herramientas negociadas
HTTP transmisible por secuenciasMcpHttpClientBuilderTiempos de espera, encabezados, inyección de autenticación y recuperación de sesiones expiradas
Registro local dinámicoMcpServerManagerAñadir, actualizar, habilitar, deshabilitar, eliminar, guardar, supervisar y reiniciar
Trabajo avanzado con SDKadk_tool::mcp::rmcpControladores de servidor, transportes, notificaciones y tipos de extensión

Ruta de la documentación

Límites importantes

  • La gestión dinámica actualmente se dirige a procesos secundarios locales de stdio.
  • La supervisión del estado del administrador detecta una conexión MCP cerrada. No demuestra que la base de datos del servidor ni su API externo estén en buen estado.
  • autoApprove se conserva para configuraciones compatibles; ADK-Rust no lo interpreta como autorización.
  • OAuth2Config realiza una solicitud de token de credenciales del cliente fija. No es el flujo completo de descubrimiento de autorización y autorización mediante navegador de MCP.
  • El muestreo, las raíces y el registro están obsoletos aguas arriba mediante SEP-2577.

Estos límites forman parte del contrato público y deben reflejarse en el diseño de la implementación.