Defining tools with MCP

MCP Server und Tool-Implementierung (Zusammenfassung)

• Ziel: Erstellung eines MCP Servers für einen CLI-Chatbot.
• Funktionalität: Der Server muss Tools bereitstellen, die der KI (Claude) zur Interaktion mit Daten dienen.
• MCP Python SDK:
• Dieses SDK vereinfacht die Server- und Tool-Erstellung erheblich.
• Es generiert automatisch die notwendigen JSON Schemas für die Tools, basierend auf der Python-Definition.
• Dies ersetzt das manuelle Schreiben komplexer JSON Schemas.
• Tool-Definition:
• Ein Tool wird durch die Definition von Name, Beschreibung und Argument(en) in Python erstellt.
• Die Implementierung erfolgt in der Datei mcpserver. py.

Implementierte Tools:

• Tool: Dokument lesen (read_doc_contents)
• Zweck: Gibt den Inhalt eines Dokuments zurück.
• Input: doc_id (String) – Die ID des zu lesenden Dokuments.
• Logik:
• Prüft, ob doc_id im In-Memory-Dictionary docs existiert.
• Wenn nicht vorhanden → ValueError auslösen.
• Wenn vorhanden → Inhalt zurückgeben (docs[doc_id]).

• Tool: Dokument bearbeiten (edit_document)
• Zweck: Ersetzt einen bestimmten Text innerhalb eines Dokuments.
• Inputs:
• doc_id (String) – ID des Dokuments.
• old_string (String) – Der Text, der ersetzt werden soll.
• new_string (String) – Der neue Text.
• Logik:
• Prüft, ob doc_id im Dictionary docs existiert.
• Wenn nicht vorhanden → ValueError auslösen.
• Wenn vorhanden → Finde-und-Ersetze-Operation durchführen (docs[doc_id]. replace(old_string, new_string)).

Takeaways

• Der MCP Server stellt Tools bereit, die der KI (Claude) zur Interaktion mit Daten dienen.
• Das MCP Python SDK automatisiert die Tool-Erstellung, indem es JSON Schemas direkt aus der Python-Definition generiert.
• Tools werden durch die Definition von Name, Beschreibung und Argument(en) in Python implementiert.
• Implementierte Tools (z. B. read_doc_contents, edit_document) prüfen die Existenz der ID im In-Memory-Dictionary und lösen bei Nicht-Existenz einen ValueError aus.