Wir werden einen CLI-basierten Chatbot erstellen, der zeigt, wie MCP-Clients und -Server zusammenarbeiten. Dieses praktische Projekt verschafft dir praktische Erfahrung mit beiden Seiten der MCP-Architektur.
Was wir bauen
Unser Chatbot ermöglicht es Benutzern, mit einer Sammlung von Dokumenten über natürliche Sprache zu interagieren. Das System besteht aus zwei Hauptkomponenten:
- Ein MCP-Client, der Benutzerinteraktionen verarbeitet und mit Claude kommuniziert
- Ein MCP-Server, der Tools zum Lesen und Aktualisieren von Dokumenten bereitstellt

Der Server stellt Claude zwei Tools zur Verfügung:
- Tool zum Lesen des Inhalts eines Dokuments
- Tool zum Aktualisieren des Inhalts eines Dokuments
Alle Dokumente werden aus Gründen der Einfachheit im Speicher abgelegt – sie umfassen Dateien wie document.pdf, spreadsheet.xlsx, report.txt und spec.md.
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 erstellen:
- Nur einen MCP-Server, um die Fähigkeiten deines Dienstes KI-Modellen zugänglich zu machen
- Nur einen MCP-Client, um dich mit vorhandenen MCP-Servern zu verbinden, die von anderen Entwicklern erstellt wurden

Wir bauen beide Komponenten in diesem Projekt ausschließlich zu Lernzwecken – um zu verstehen, wie sie kommunizieren und zusammenarbeiten.
Projekt-Setup
Lade cli_project.zip aus dem Downloads-Bereich am Ende dieser Lektion herunter und entpacke es in dein bevorzugtes Entwicklungsverzeichnis. Öffne deinen Code-Editor im Projektordner.
Konfiguration
Das Projekt enthält eine README.md-Datei mit detaillierten Einrichtungsanweisungen. Du musst:
- Deinen Anthropic-API-Key zur .env-Datei hinzufügen
- Abhängigkeiten entweder mit UV (empfohlen) oder pip installieren

Die .env-Datei sollte Folgendes enthalten:
ANTHROPIC_API_KEY="your-api-key-here"Ausführen des Projekts
Sobald das Setup abgeschlossen ist, navigiere in deinem Terminal zu deinem Projektverzeichnis und führe aus:
# Bei Verwendung von UV (empfohlen)
uv run main.py
# Bei Verwendung von Standard-Python
python main.pyEs sollte eine Chat-Eingabeaufforderung erscheinen. Teste sie, indem du eine einfache Frage stellst wie „Was ist 1+1?“, um sicherzustellen, dass alles korrekt funktioniert.
Das Starterprojekt enthält bereits grundlegende Chat-Funktionalität mit Claude. In den folgenden Videos fügen wir MCP-Server-Fähigkeiten und Dokumentenverwaltungsfunktionen hinzu, um einen vollständig funktionsfähigen, dokumentenbewussten Chatbot zu erstellen.
Downloads
- Herunterladen
Starter project (cli_project.zip)
The chatbot project you build on for the rest of this section.
- Herunterladen
Completed project (cli_project_COMPLETE.zip)
The finished version, for checking your work.