Ir al contenido principal

access_mcp_resource

La herramienta access_mcp_resource recupera datos de recursos expuestos por servidores del Protocolo de Contexto de Modelo (MCP) conectados. Permite a AI Cockpit Reasoning acceder a archivos, respuestas de API, documentación o información del sistema que proporciona contexto adicional para las tareas.

Parámetros​

La herramienta acepta estos parámetros:

  • server_name (requerido): El nombre del servidor MCP que proporciona el recurso
  • uri (requerido): El URI que identifica el recurso específico al que acceder

Qué Hace​

Esta herramienta se conecta a los servidores MCP y obtiene datos de sus recursos expuestos. A diferencia de use_mcp_tool que ejecuta acciones, esta herramienta específicamente recupera información que sirve como contexto para las tareas.

¿Cuándo se usa?​

  • Cuando AI Cockpit Reasoning necesita contexto adicional de sistemas externos
  • Cuando AI Cockpit Reasoning necesita acceder a datos específicos del dominio de servidores MCP especializados
  • Cuando AI Cockpit Reasoning necesita recuperar documentación de referencia alojada por servidores MCP
  • Cuando AI Cockpit Reasoning necesita integrar datos en tiempo real de APIs externas a través de MCP

Características Principales​

  • Recupera datos de texto e imagen de recursos MCP
  • Requiere aprobación del usuario antes de ejecutar el acceso a recursos
  • Usa direccionamiento basado en URI para identificar con precisión los recursos
  • Se integra con el SDK del Protocolo de Contexto de Modelo
  • Muestra el contenido del recurso apropiadamente según el tipo de contenido
  • Admite tiempos de espera para operaciones de red confiables
  • Maneja los estados de conexión del servidor (conectado, conectando, desconectado)
  • Descubre los recursos disponibles de los servidores conectados
  • Procesa datos de respuesta estructurados con metadatos
  • Maneja la representación especial del contenido de imagen

Limitaciones​

  • Depende de que los servidores MCP externos estén disponibles y conectados
  • Limitada a los recursos proporcionados por los servidores conectados
  • No puede acceder a recursos de servidores deshabilitados
  • Los problemas de red pueden afectar la confiabilidad y el rendimiento
  • El acceso a recursos está sujeto a los tiempos de espera configurados
  • Los formatos de URI están determinados por la implementación específica del servidor MCP
  • Sin capacidades de acceso a recursos sin conexión o en caché

Cómo Funciona​

Cuando se invoca la herramienta access_mcp_resource, sigue este proceso:

  1. Validación de Conexión:

    • Verifica que un hub MCP esté disponible e inicializado
    • Confirma que el servidor especificado existe en la lista de conexiones
    • Verifica si el servidor está deshabilitado (devuelve un error si lo está)

  2. Aprobación del Usuario:

    • Presenta la solicitud de acceso al recurso al usuario para su aprobación
    • Proporciona el nombre del servidor y el URI del recurso para verificación del usuario
    • Procede solo si el usuario aprueba el acceso al recurso

  3. Solicitud de Recurso:

    • Usa el SDK del Protocolo de Contexto de Modelo para comunicarse con los servidores
    • Realiza una solicitud resources/read al servidor a través del hub MCP
    • Aplica los tiempos de espera configurados para prevenir bloqueos en servidores que no responden

  4. Procesamiento de Respuestas:

    • Recibe una respuesta estructurada con metadatos y arrays de contenido
    • Procesa el contenido de texto para su visualización al usuario
    • Maneja los datos de imagen especialmente para una visualización apropiada
    • Devuelve los datos del recurso procesados a AI Cockpit Reasoning para su uso en la tarea actual

Tipos de Recursos​

Los servidores MCP pueden proporcionar dos tipos principales de recursos:

  1. Recursos Estándar:

    • Recursos fijos con URIs específicos
    • Nombre, descripción y tipo MIME definidos
    • Acceso directo sin parámetros
    • Típicamente representan datos estáticos o información en tiempo real

  2. Plantillas de Recursos:

    • Recursos parametrizados con valores de marcador de posición en los URIs
    • Permiten la generación dinámica de recursos basada en los parámetros proporcionados
    • Pueden representar consultas o vistas filtradas de datos
    • Más flexibles pero requieren formateo adicional de URI

Ejemplos de Uso​

  • Al ayudar con el desarrollo de API, AI Cockpit Reasoning recupera las especificaciones de endpoints de los recursos MCP para garantizar una implementación correcta.
  • Al asistir con la visualización de datos, AI Cockpit Reasoning accede a muestras de datos actuales de los servidores MCP conectados.
  • Al trabajar en dominios especializados, AI Cockpit Reasoning recupera documentación técnica para proporcionar orientación precisa.
  • Al generar código específico de la industria, AI Cockpit Reasoning hace referencia a los requisitos de cumplimiento de los recursos de documentación.

Ejemplos de Uso​

Acceder a datos meteorológicos actuales:

<access_mcp_resource>
<server_name>weather-server</server_name>
<uri>weather://san-francisco/current</uri>
</access_mcp_resource>

Recuperar documentación de API:

<access_mcp_resource>
<server_name>api-docs</server_name>
<uri>docs://payment-service/endpoints</uri>
</access_mcp_resource>

Acceder a conocimiento específico del dominio:

<access_mcp_resource>
<server_name>knowledge-base</server_name>
<uri>kb://medical/terminology/common</uri>
</access_mcp_resource>

Obtener configuración del sistema:

<access_mcp_resource>
<server_name>infra-monitor</server_name>
<uri>config://production/database</uri>
</access_mcp_resource>