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

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

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

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