Defining tools with MCP

Studie-opmerkingen: MCP Server en Tool Implementatie

Doel en Context

• Het doel is het bouwen van een MCP (Model Context Protocol) server voor een CLI chat bot.
• De server moet extra functionaliteit bieden via tools (functies) die de bot kan aanroepen.
• De implementatie vindt plaats in het bestand MCP server. py.
• Er wordt gewerkt met een in-memory verzameling documenten (docs dictionary).

Kernconcept: MCP Python SDK

• Het gebruik van het officiële MCP Python SDK vereenvoudigt het proces aanzienlijk.
• Het SDK maakt het mogelijk om tools te definiëren zonder handmatig complexe JSON schemas te schrijven.
• Wanneer een tool wordt gedefinieerd (met functies en velden), genereert het MCP automatisch het benodigde tool JSON schema voor Bedrock.

Tool Definitie Proces

• Een tool wordt gedefinieerd door een Python functie te schrijven en deze te markeren met de MCP-tool decorator (MCP. tool).
• De tool-definitie vereist een naam, een beschrijving en gedefinieerde argumenten (met type en beschrijving).

Implementatie van Tools

**1. Tool: Document Lezen (read doc contents)**

• Doel: De inhoud van een specifiek document retourneren.
• Input: doc_id (string) → ID van het document.
• Logica:
• Controleer of doc_id in de docs dictionary bestaat.
• Indien niet gevonden, gooi een ValueError met de boodschap "doc with ID [doc_id] not found".
• Indien gevonden, retourneer de waarde docs[doc_id].

**2. Tool: Document Bewerken (edit document)**

• Doel: Een specifieke string in de inhoud van een document vervangen.
• Inputs:
• doc_id (string) → ID van het document dat bewerkt moet worden.
• old_string (string) → De tekst die exact vervangen moet worden (inclusief witruimtes).
• new_string (string) → De nieuwe tekst die de oude string vervangt.
• Logica:
• Controleer of doc_id in de docs dictionary bestaat.
• Indien gevonden, voer een 'find and replace' uit op de inhoud van docs[doc_id].

Takeaways

• Het doel van de MCP server is het bieden van extra functionaliteit aan een CLI chatbot via tools (functies) die de bot kan aanroepen.
• Het MCP Python SDK vereenvoudigt de implementatie door automatisch de benodigde tool JSON schemas voor Bedrock te genereren.
• Tools worden gedefinieerd door een Python functie te schrijven en deze te markeren met de MCP. tool decorator, inclusief naam, beschrijving en argumenten.
• De tools interageren met een in-memory docs dictionary om documentinhoud te lezen of te bewerken (find and replace).