Defining resources

📚 Studieopmerkingen: MCP Resources

🎯 Doel van de Feature

• Document Mentioning: Toestaan dat gebruikers documenten kunnen noemen (bijv. met @documentname) binnen een bericht.
• Automatisering: Het systeem moet automatisch de inhoud van het genoemde document ophalen en deze preemptief in de prompt voor Claude injecteren.
• Voordeel: Het model (Claude) hoeft niet zelf een tool te gebruiken om de inhoud van het document te vinden; de context wordt vooraf geleverd.

⚙️ MCP Resources

• Definitie: Resources zijn mechanismen waarmee de MCP Server data kan blootstellen aan de Client.
• Principe: Er wordt idealiter één resource gedefinieerd voor elke unieke leesoperatie.
• Gebruik: Ze worden aangeroepen via de MCP Client.

🏷️ Types Resources

• Direct Resource (Static Resource):
• Heeft een vaste, onveranderlijke URI (bijv. docs://documents).
• De URI is altijd exact hetzelfde.
• Templated Resource:
• Heeft één of meer parameters (wildcards) in de URI (bijv. docs://documents/{doc_id}).
• De parameters worden automatisch door de SDK geparsed en als keyword arguments aan de functie doorgegeven.
• Nuttig voor variatie en selectie (bijv. ophalen van een specifiek document).

🔄 De Workflow (Client → Server)

• Trigger (Autocomplete): Wanneer de gebruiker @ typt, vraagt de Client de MCP Server om een lijst met beschikbare documenten.
• Request: De Client stuurt een Read Resource Request naar de Server, inclusief de URI.
• Server Actie: De MCP Server identificeert de URI en voert de bijbehorende functie uit.
• Response: De Server stuurt een Read Resource Result terug aan de Client met de gevraagde data.

🛠️ Implementatievoorbeelden

• Resource 1: Lijst Documenten (Autocomplete)
• Type: Direct Resource.
• URI: docs://documents.
• MIME Type: application/json (om gestructureerde data aan te geven).
• Functie: Retourneert een lijst van document-ID's (namen).
• Resource 2: Document Inlezen (Content Fetch)
• Type: Templated Resource.
• URI: docs://documents/{doc_id}.
• MIME Type: text/plain (om aan te geven dat het pure tekst is).
• Functie: Ontvang doc_id als argument → controleert of het ID bestaat → retourneert de documentinhoud (string).

Takeaways

• MCP Resources zijn mechanismen die de MCP Server data blootstellen aan de Client, waardoor documentinhoud automatisch in de prompt wordt geïnjectieerd.
• Er zijn twee types resources: Direct Resources (vaste URI, bijv. voor het ophalen van een lijst) en Templated Resources (URI met parameters, bijv. voor het ophalen van een specifiek document).
• De workflow verloopt via een Read Resource Request van de Client naar de Server, die vervolgens de bijbehorende functie uitvoert en een Read Resource Result terugstuurt.
• Direct Resources hebben een vaste URI (bijv. docs://documents), terwijl Templated Resources variabel zijn (bijv. docs://documents/{doc_id}).