Cargando
Cargando

Los recursos en MCP permiten que tu servidor exponga datos que pueden incluirse directamente en los prompts, en lugar de requerir llamadas a herramientas para acceder a la información. Esto crea una forma más eficiente de proporcionar contexto a modelos de IA como Claude.

Entendiendo el flujo de recursos

Para completar el autocompletado, el cliente MCP lee docs://documents desde el servidor MCP y devuelve los nombres de los documentos a nuestro código.

Cuando un usuario quiere acceder al contenido de un recurso, el flujo funciona así:

  • El usuario solicita información sobre un recurso (como "@report.pdf")
  • Tu código necesita una lista de nombres de documentos para el autocompletado
  • El cliente MCP envía una ReadResourceRequest al servidor MCP
  • El servidor responde con un ReadResourceResult que contiene los datos del recurso
  • Tu código puede entonces colocar estos datos directamente en los prompts

Implementando la lectura de recursos

Para leer recursos desde tu cliente MCP, necesitarás implementar una función read_resource. Primero, agrega las importaciones necesarias:

python
import json
from pydantic import AnyUrl

La función principal realiza una solicitud a tu sesión MCP y procesa la respuesta:

python
async def read_resource(self, uri: str) -> Any:
    result = await self.session().read_resource(AnyUrl(uri))
    resource = result.contents[0]

Manejo de diferentes tipos de recursos

Los recursos pueden devolver distintos tipos de contenido, por lo que necesitas verificar el tipo MIME y analizarlo en consecuencia:

python
if isinstance(resource, types.TextResourceContents):
    if resource.mimeType == "application/json":
        return json.loads(resource.text)
    
    return resource.text

Este enfoque maneja dos escenarios principales:

  • Recursos JSON que necesitan ser analizados
  • Recursos de texto plano que pueden devolverse tal cual

Probando el acceso a recursos

Pestaña Resources del MCP Inspector: al leer docs://documents/report.pdf se devuelve el mimeType "text/plain" y el texto del informe.

Puedes verificar que tu implementación de recursos funciona probándola en tu aplicación. Cuando escribes "@" seguido de un nombre de recurso, deberías ver una lista de autocompletado con los recursos disponibles. Al seleccionar uno, se incluirá su contenido directamente en tu prompt.

La ventaja clave de este enfoque es la eficiencia: Claude recibe el contenido del documento de inmediato sin necesidad de realizar llamadas a herramientas adicionales para acceder a la información.

Uso de recursos frente a herramientas

Los recursos son particularmente útiles cuando:

  • Tienes contenido estático o semiestático que se referencia con frecuencia
  • Quieres reducir el número de llamadas a la API
  • El contenido debe estar disponible de inmediato en el contexto del prompt

Esto difiere de las herramientas, que son mejores para operaciones dinámicas o cuando necesitas que la IA decida si acceder a cierta información según el contexto de la conversación.