KurrentDB MCP Server

Was macht der “KurrentDB” MCP Server?

Der KurrentDB MCP Server ist ein Tool, das KI-Assistenten und Entwicklern ermöglicht, nahtlos mit KurrentDB, einer streambasierten Datenbank, zu interagieren. Durch die Bereitstellung einer Reihe von Tools und standardisierten Operationen können Clients Stream-Daten abfragen, lesen und schreiben sowie Projektionen direkt aus KI-Entwicklungsumgebungen erstellen und verwalten. Diese Integration verbessert Workflows, indem Aufgaben wie das Abrufen von Event-Streams, das Aufzeichnen neuer Events und das Erstellen von Datenprojektionen programmatisch oder per natürlicher Sprache ausgeführt werden können. Der KurrentDB MCP Server vereinfacht Prototyping, Debugging und die Erkundung von ereignisgesteuerten Daten und ist besonders wertvoll für schnelle Entwicklung und Analysen in Anwendungen, die auf KurrentDB aufbauen.

Liste der Prompts

• read_stream: Vorlage zum Abrufen von Events aus einem angegebenen Stream, mit Optionen für Richtung und Begrenzungen.
• write_events_to_stream: Vorlage zum Hinzufügen von Events zu einem Stream, einschließlich Event-Typ, Daten und Metadaten.
• list_streams: Vorlage zum Auflisten verfügbarer Streams, unterstützt Paginierung und Richtung.
• build_projection: Vorlage zur Beschreibung und Generierung einer neuen Projektion mit KI-Unterstützung.
• create_projection: Vorlage zum Erstellen einer Projektion aus einer Spezifikation.
• update_projection: Vorlage zum Aktualisieren einer bestehenden Projektion.
• test_projection: Vorlage zum Testen einer Projektion mit Beispieldaten.
• get_projections_status: Vorlage zum Abrufen des Status aller Projektionen.

Liste der Ressourcen

• Stream-Daten: Zugriff auf Event-Datenströme innerhalb von KurrentDB, zum Lesen und Analysieren.
• Streams-Liste: Liste und Metadaten der verfügbaren Streams in der Datenbank.
• Projektionen: Definitionen und berechnete Sichten (Projektionen), die aus Stream-Daten erzeugt werden.
• Projektionen-Status: Echtzeit-Statusinformationen zu bestehenden Projektionen.

Liste der Tools

• read_stream: Liest Events aus einem bestimmten Stream, mit Optionen für Reihenfolge (rückwärts/vorwärts) und Anzahl.
• write_events_to_stream: Fügt einem Stream neue Events mit eigenen Daten, Event-Typ und Metadaten hinzu.
• list_streams: Gibt eine Liste aller verfügbaren Streams in der KurrentDB-Instanz zurück.
• build_projection: Nutzt KI, um eine Projektion basierend auf Benutzeranforderungen zu erzeugen.
• create_projection: Erstellt eine neue Projektion in KurrentDB.
• update_projection: Aktualisiert eine bestehende Projektion mit neuen Spezifikationen.
• test_projection: Testet eine Projektion mit Beispieldaten oder Szenarien.
• get_projections_status: Ruft Status- und Gesundheitsinformationen für alle Projektionen ab.

Anwendungsfälle für diesen MCP Server

• Datenbank-Event-Exploration: Entwickler können historische oder Echtzeit-Event-Daten in jedem KurrentDB-Stream schnell einsehen, filtern und analysieren – ideal für Troubleshooting und Audits.
• Event-Erfassung und Logging: Neue Events (z. B. Nutzeraktionen, Systemänderungen) programmatisch direkt in die Datenbank schreiben für robustes Event Sourcing und Nachvollziehbarkeit.
• Projektionserstellung und Debugging: Projektionen für Analysen oder abgeleitete Datenmodelle schnell entwickeln, testen und verfeinern – das verkürzt Feedbackzyklen für datengetriebene Features.
• Stream-Metadaten-Entdeckung: Alle Streams auflisten und Struktur/Metadaten untersuchen, um das Schema-Design oder die Datennavigation zu unterstützen.
• Operatives Monitoring: Tools nutzen, um Status und Gesundheit von Projektionen zu prüfen und sicherzustellen, dass wichtige Daten-Transformationen wie erwartet laufen.

Einrichtung

Windsurf

1. Voraussetzungen: Stellen Sie sicher, dass Python installiert ist und KurrentDB mit aktivierten Projektionen läuft (--run-projections=all --start-standard-projections).
2. Konfiguration finden: Öffnen Sie .codeium/windsurf/mcp_config.json.
3. KurrentDB MCP Server hinzufügen:

   {
     "mcpServers": {
       "kurrentdb": {
         "command": "python",
         "args": ["Pfad zum mcp-server Ordner\\server.py"],
         "env": {
           "KURRENTDB_CONNECTION_STRING": "hier KurrentDB-Verbindung einfügen"
         }
       }
     }
   }
   

4. Speichern und Neustarten: Konfiguration speichern und Windsurf neu starten.
5. Setup überprüfen: Sicherstellen, dass der MCP Server aktiv und verbunden ist.

Claude

1. Voraussetzungen: Python installiert, KurrentDB läuft mit den erforderlichen Projektions-Flags.
2. Konfiguration finden: Bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei.
3. KurrentDB MCP Server hinzufügen:

   {
     "servers": {
       "KurrentDB": {
         "type": "stdio",
         "command": "uv",
         "args": [
           "--directory",
           "Pfad zum mcp-server Ordner",
           "run",
           "server.py"
         ],
         "env": {
           "KURRENTDB_CONNECTION_STRING": "hier KurrentDB-Verbindung einfügen"
         }
       }
     }
   }
   

4. Speichern und Neustarten: Speichern und Claude Desktop neu starten.
5. Überprüfen: Sicherstellen, dass KurrentDB MCP in der Claude-Oberfläche angezeigt wird.

Cursor

1. Voraussetzungen: Python und KurrentDB wie oben eingerichtet.
2. Konfiguration finden: Bearbeiten Sie .cursor/mcp.json.
3. KurrentDB MCP Server hinzufügen:

   {
     "mcpServers": {
       "kurrentdb": {
         "command": "python",
         "args": ["Pfad zum mcp-server Ordner\\server.py"],
         "env": {
           "KURRENTDB_CONNECTION_STRING": "hier KurrentDB-Verbindung einfügen"
         }
       }
     }
   }
   

4. Speichern und Neustarten: Änderungen übernehmen und Cursor neu starten.
5. Überprüfen: Sicherstellen, dass der MCP Server läuft und erreichbar ist.

Cline

Keine spezifischen Anweisungen im Repository für die Einrichtung mit Cline vorhanden.

API-Schlüssel absichern

Verwenden Sie Umgebungsvariablen in Ihrer Konfiguration:

"env": {
  "KURRENTDB_CONNECTION_STRING": "hier KurrentDB-Verbindung einfügen"
}

So bleiben Zugangsdaten sicher und gelangen nicht in die Versionsverwaltung.

Verwendung dieses MCP in Flows

Verwendung von MCP in FlowHunt

Um MCP Server in Ihren FlowHunt-Workflow zu integrieren, fügen Sie die MCP-Komponente zu Ihrem Flow hinzu und verbinden Sie sie mit Ihrem KI-Agenten:

Klicken Sie auf die MCP-Komponente, um das Konfigurationspanel zu öffnen. Im Bereich System-MCP-Konfiguration geben Sie die Details Ihres MCP Servers mit diesem JSON-Format ein:

{
  "kurrentdb": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Nach der Konfiguration kann der KI-Agent diesen MCP als Tool mit Zugriff auf alle Funktionen und Möglichkeiten nutzen. Denken Sie daran, “kurrentdb” durch den tatsächlichen Namen Ihres MCP Servers zu ersetzen und die URL entsprechend Ihrer MCP-Server-URL anzupassen.

Übersicht

Unsere Meinung

Der KurrentDB MCP Server ist gut dokumentiert und bietet einen umfassenden Satz an Tools und Ressourcen für die Interaktion mit Streams und Projektionen in KurrentDB. Die Konfigurationsanleitung ist für die wichtigsten Plattformen klar verständlich, jedoch werden einige fortgeschrittene MCP-Features wie Roots und Sampling nicht erwähnt. Insgesamt ist dieser MCP für den vorgesehenen Datenbank-Einsatzzweck robust.

Bewertung: 8/10

MCP Score