Defining resources

📝 Studieopmerkingen: MCP Resources

**1. Doel van Resources in MCP Servers**

• Resources stellen de MCP server in staat om specifieke data (read operations) bloot te geven aan de client.
• Ze worden gebruikt om context te leveren aan de client, bijvoorbeeld door documentinhoud automatisch in een prompt te injecteren.

**2. De Functionaliteit van Document-Mentions**

• Doel: Gebruikers kunnen documenten noemen met een @ symbool (bijv. @report. pdf).
• Twee aspecten:
• Autocomplete: Wanneer de gebruiker @ typt, toont de MCP een lijst van beschikbare documenten.
• Content Fetching: Bij verzending van de boodschap haalt de MCP de inhoud van het genoemde document en voegt deze preemptief toe aan de prompt voor Claude.

**3. Types Resources**

• Direct Resource (Statische Resource):
• Heeft een vaste, onveranderlijke URI (bijv. docs://documents).
• Wordt gebruikt voor algemene, vaste data-opvragingen.
• Templated Resource:
• Heeft één of meer parameters (wildcards) in de URI (bijv. docs://documents/{doc_id}).
• De Python MCP SDK parseert deze parameters automatisch en geeft ze door als keyword arguments aan de functie.
• Wordt gebruikt voor variabele of specifieke opvragingen.

**4. Workflow van een Resource Request**

• Client Actie: De client (MCP Client) stuurt een Read Resource Request.
• Request Inhoud: De request bevat de URI van de gewenste resource.
• Server Verwerking: De MCP Server identificeert de URI en voert de bijbehorende functie uit.
• Resultaat: De server stuurt een Read Resource Result terug aan de client.

**5. Implementatie Details (Voorbeelden)**

• Resource 1: Lijst Documenten (Autocomplete)
• URI: docs://documents
• MIME Type: application/json (om gestructureerde data te hint-en)
• Output: Een lijst van document-ID's (namen).
• Resource 2: Haal Document Inhoud (Fetch Doc)
• URI: docs://documents/{doc_id} (Templated)
• MIME Type: text/plain (om aan te geven dat het pure tekst is)
• Output: De tekstinhoud van het specifieke document.

Takeaways

• Resources stellen de MCP server in staat om specifieke data (read operations) bloot te geven aan de client, wat context levert (bijv. documentinhoud injecteren in een prompt).
• Document-mentions (met @) bieden autocomplete en laten de MCP de inhoud van het document automatisch ophalen en toevoegen aan de prompt.
• Er zijn twee types resources: Direct (vaste URI) en Templated (variabele URI met parameters/wildcards).
• Templated Resources gebruiken parameters (wildcards) die de Python MCP SDK automatisch parseert en doorgeeft als keyword arguments.