Defining tools with MCP

MCP Server und Tool-Implementierung (Zusammenfassung)

• Ziel: Erstellung eines MCP Servers für den CLI-Chatbot.
• Funktionalität: Der Server muss Tools (Funktionen) enthalten, die der KI zur Interaktion mit Daten bereitstellt.
• Implementierung: Der Server-Code wird in der Datei MCP server. py im Stammverzeichnis des Projekts platziert.

Schlüsselkonzept: MCP Python SDK

• Vorteil: Das offizielle MCP Python SDK vereinfacht die Server- und Tool-Erstellung erheblich.
• Automatisierung: Das SDK generiert automatisch die notwendigen Tool JSON Schemas, die an die KI (z. B. Claude) übergeben werden.
• Definition: Tools werden durch die Definition von Name, Beschreibung und erforderlichen Argumenten erstellt.

Tool 1: Dokument lesen (Read Doc Contents)

• Zweck: Liest den Inhalt eines Dokuments basierend auf dessen ID.
• Argument: doc ID (String) – Die ID des zu lesenden Dokuments.
• Logik:
• Prüfen, ob doc ID im in-memory docs-Dictionary existiert.
• Wenn nicht vorhanden → ValueError auslösen ("doc with ID doc ID not found").
• Wenn vorhanden → Inhalt von docs[doc ID] zurückgeben.

Tool 2: Dokument bearbeiten (Edit Document)

• Zweck: Ersetzt einen bestimmten Text innerhalb eines Dokuments.
• Argument:
• doc ID (String) – ID des Dokuments.
• old string (String) – Der Text, der ersetzt werden soll (exakte Übereinstimmung erforderlich).
• new string (String) – Der neue Text, der eingefügt werden soll.
• Logik:
• Prüfen, ob doc ID im docs-Dictionary existiert.
• Wenn nicht vorhanden → ValueError auslösen.
• Wenn vorhanden → Finde und ersetze old string durch new string in docs[doc ID].

Takeaways

• Der MCP Server dient der Bereitstellung von Tools (Funktionen) für die Interaktion der KI mit Daten.
• Das MCP Python SDK vereinfacht die Server- und Tool-Erstellung und generiert automatisch die notwendigen Tool JSON Schemas.
• Tools werden durch die Definition von Name, Beschreibung und erforderlichen Argumenten erstellt.
• Dokumententools (Read/Edit) prüfen die Existenz der doc ID im docs-Dictionary und lösen bei Nicht-Existenz einen ValueError aus.