Defining resources

📝 Studieopmerkingen: MCP Resources

💡 Kernconcept: Resources

• Definitie: Resources zijn een functie binnen MCP servers die data blootstellen aan de client.
• Doel: Ze maken het mogelijk om specifieke leesoperaties (read operations) te definiëren.
• Principe: Meestal wordt één resource gedefinieerd voor elke unieke leesoperatie.

⚙️ Gebruiksscenario: Document Mentions

• Doel: Een gebruiker kan een document noemen (bijv. @report. pdf). De MCP server haalt de inhoud van dit document op en voegt deze proactief toe aan de prompt die naar Claude wordt gestuurd.
• Twee Functies:
• Autocomplete: Toon een lijst van alle beschikbare documenten wanneer de gebruiker het @ symbool typt.
• Content Fetching: Haal de volledige inhoud van het gespecificeerde document op wanneer de gebruiker het bericht verzendt.

🛠️ Resource Types

Er zijn twee hoofdtypen 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/{doc_id}).
• De Python MCP SDK parseert deze parameters automatisch en geeft ze door als keyword arguments aan de functie.
• Dit wordt gebruikt voor variatie en specificatie (bijv. het opzoeken van een specifiek document).

🔄 Workflow (Client → Server)

• Client Actie: De client (MCP Client) initieert een leesresource-aanvraag (Read Resource Request).
• URI: Deze aanvraag 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 het resultaat terug in een Read Resource Result message.
• Client Gebruik: De client gebruikt de data in het resultaat (bijv. om de autocomplete te vullen of de prompt te genereren).

💻 Implementatie Details

• Decorators: Resources worden gedefinieerd met de @mcp. resource decorator.
• MIME Type: Dit is een hint aan de client over het type data dat wordt geretourneerd (bijv. application/json of text/plain).
• Voorbeeld 1 (Lijst Documenten):
• URI: docs://documents (Direct)
• MIME Type: application/json
• Output: Een lijst van document-ID's (namen).
• Voorbeeld 2 (Haal Document Op):
• URI: docs/{doc_id} (Templated)
• MIME Type: text/plain
• Input: doc_id wordt automatisch doorgegeven als keyword argument.
• Output: De tekstinhoud van het document.

Takeaways

• Resources zijn functies binnen MCP servers die data blootstellen aan de client via specifieke leesoperaties.
• Er zijn twee hoofdtypen: Direct Resources (vaste, onveranderlijke URI) en Templated Resources (URI met parameters/wildcards).
• Templated Resources gebruiken parameters (bijv. {doc_id}) die de MCP SDK automatisch parseert en doorgeeft als keyword arguments aan de functie.
• De workflow verloopt via een Read Resource Request van de client, verwerking door de server, en het terugsturen van een Read Resource Result.