Wird geladen
Wird geladen

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

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

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

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

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:

  1. Deinen Anthropic-API-Key zur .env-Datei hinzufügen
  2. Abhängigkeiten entweder mit UV (empfohlen) oder pip installieren

Die Projekt-README.md mit Schritt 1 zum Setzen von ANTHROPIC_API_KEY in der .env-Datei und Schritt 2 zum Installieren der Abhängigkeiten.

Die .env-Datei sollte Folgendes enthalten:

bash
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:

bash
# Bei Verwendung von UV (empfohlen)
uv run main.py

# Bei Verwendung von Standard-Python
python main.py

Es 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

  • 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.

    Herunterladen