Wird geladen
Wird geladen

Wir werden unseren eigenen CLI-basierten Chatbot bauen, um besser zu verstehen, wie MCP-Clients und -Server zusammenarbeiten. Dieses praktische Projekt gibt dir praktische Erfahrung mit beiden Seiten der MCP-Architektur.

Was wir bauen

Unser Chatbot wird eine Kommandozeilenschnittstelle sein, die es Nutzern ermöglicht, mit einer Reihe von Dokumenten zu chatten. Hier ist, was das System umfassen wird:

  • Eine CLI-basierte Chatbot-Schnittstelle
  • Fähigkeiten zum Lesen und Bearbeiten von Dokumenten für Claude
  • Dokument-„Mention“-Funktionalität mit der @doc_name-Syntax
  • Befehlsausführung mit der /command_name-Syntax
  • Eine Sammlung von Fake-Dokumenten, die im Speicher abgelegt sind

Die Eingabe von @ in einem Prompt listet deposition.md, design.md, financials.md, outlook.md, plan.md und spec.md auf, alle mit der Bezeichnung „Resource“.

Systemarchitektur

Das Projekt besteht aus drei Hauptkomponenten, die zusammenarbeiten:

  • Unser MCP-Client – Kümmert sich um die Nutzerinteraktion und die Chat-Oberfläche
  • Unser MCP-Server – Stellt Tools für Dokumentoperationen bereit
  • Dokumentspeicher – In-Memory-Sammlung verschiedener Dateitypen

Unser Server enthält unseren MCP-Client, der in beide Richtungen mit unserem MCP-Server kommuniziert, dessen Tools vier Dokumente lesen und aktualisieren.

Der MCP-Server wird zwei Kern-Tools implementieren:

  • Tool zum Lesen von Dokumentinhalten
  • Tool zum Aktualisieren von Dokumentinhalten

Alle Dokumente (PDFs, Tabellenkalkulationen, Textdateien, Markdown-Dateien) werden im Speicher und nicht auf der Festplatte abgelegt, damit das Projekt einfach bleibt und sich auf MCP-Konzepte konzentriert.

Wichtiger Hinweis zur Architektur

In realen Projekten implementierst du in der Regel entweder einen MCP-Client oder einen MCP-Server – nicht beides. Du könntest:

  • Einen MCP-Server bauen, um einen Dienst an andere Entwickler zu verteilen
  • Einen MCP-Client bauen, der sich mit bestehenden MCP-Servern von Drittanbietern verbindet

Diagramm unseres Servers, der den MCP-Client enthält, der sich in beide Richtungen mit einem separaten MCP-Server verbindet.

Unser Projekt implementiert beide Komponenten in einer einzigen Codebasis rein zu Lernzwecken, damit du sehen kannst, wie Clients und Server miteinander interagieren.