Couchbase MCP Server

Der Couchbase MCP Server verbindet KI-Assistenten wie Claude, Cursor, Windsurf oder VS Code mit Couchbase-Clustern. Wer Couchbase als Datenbank für Anwendungen nutzt, kann seinen Assistenten fragen, welche Buckets, Scopes und Collections es gibt, wie Dokumente aufgebaut sind oder warum eine Abfrage langsam läuft, ohne zwischen Editor, Abfragewerkzeug und Admin-Oberfläche zu wechseln. Der Server wird im Repository couchbase/mcp-server-couchbase entwickelt, steht unter der Apache-2.0-Lizenz und funktioniert laut Anbieter sowohl mit Couchbase Capella als auch mit selbst betriebenen Clustern.

Was ist der Couchbase MCP Server?

Es handelt sich um einen selbst gehosteten Server, den Sie lokal oder in Ihrer eigenen Umgebung betreiben. Er wird als Python-Paket über PyPI verteilt und per uvx couchbase-mcp-server gestartet; alternativ gibt es ein Docker-Image und den Aufbau aus dem Quellcode. Voraussetzung sind laut README Python 3.10 oder neuer und das Werkzeug uv. Als Transport ist stdio voreingestellt, zusätzlich wird Streamable HTTP unterstützt, etwa für den Betrieb als gemeinsamer Dienst. Die Verbindung zum Cluster wird über Umgebungsvariablen wie CB_CONNECTION_STRING, CB_USERNAME und CB_PASSWORD festgelegt; für TLS-Verbindungen zu selbst betriebenen Clustern kommen Zertifikatspfade hinzu.

Welche Werkzeuge stehen zur Verfügung?

Die Dokumentation gliedert die Werkzeuge in mehrere Bereiche. Zum Erkunden gehören Cluster-Zustand und Schema-Erkennung für Buckets, Scopes und Collections. Dokumente lassen sich per Key-Value-Zugriff lesen, anlegen, ersetzen und löschen, auch teilweise per Sub-Document-Änderung. Für Abfragen gibt es SQL++, außerdem Indexverwaltung samt Index Advisor, der Indizes vorschlägt, sowie Werkzeuge zur Analyse der Abfrageleistung, etwa der langsamsten oder häufigsten Abfragen. Hinzu kommen Volltext- und Vektorsuche sowie ein separater Satz von Operational-Insights-Werkzeugen. Einige Funktionen setzen laut README neuere Server-Versionen voraus, etwa die Suchwerkzeuge ab 7.6, und einzelne Werkzeuge gibt es nur für selbst verwaltete Cluster, nicht für Capella.

Wofür ist er besonders nützlich?

Der größte Nutzen liegt in der alltäglichen Entwicklungsarbeit: Der Assistent liest das Schema, schreibt passende SQL++-Abfragen, prüft Ergebnisse und schlägt Indizes vor, wenn eine Abfrage zu viele Dokumente durchsucht. Bei Performance-Problemen kann er die langsamsten Abfragen auswerten und Hinweise geben. Gegenüber einem generischen Datenbankserver kennt dieser Server Konzepte wie Scopes, Collections, den Index Advisor und die Suchdienste von Couchbase und liefert dadurch Antworten, die zur Plattform passen.

Sicherheit: Nur-Lese-Modus als Standard

Der Server ist laut Anbieter „sicher voreingestellt“: CB_MCP_READ_ONLY_MODE steht standardmäßig auf true. Dann werden schreibende Werkzeuge nicht geladen, und SQL++-Anweisungen, die Daten oder Strukturen verändern, werden blockiert. Zu den schreibenden Werkzeugen zählen das Anlegen und Löschen von Scopes und Collections, das Ändern und Löschen von Dokumenten, das Anlegen und Löschen von Indizes und das Abbrechen laufender Abfragen. Über CB_MCP_DISABLED_TOOLS lassen sich einzelne Werkzeuge ausschalten, über CB_MCP_CONFIRMATION_REQUIRED_TOOLS verlangen Sie für ausgewählte Werkzeuge eine ausdrückliche Bestätigung, sofern der Client diese Rückfrage unterstützt. Die Dokumentation betont, dass das Abschalten von Werkzeugen keine Garantie ist: Maßgeblich bleiben die Zugriffsrechte des Datenbankbenutzers. Legen Sie deshalb einen eigenen Benutzer mit minimalen Rechten an.

Support und Reifegrad

Die Angaben des Anbieters sind hier nicht ganz einheitlich. Die README bezeichnet das Projekt als von der Couchbase-Community gepflegt und nicht offiziell vom Support-Team unterstützt; Anfragen sollen über GitHub laufen. Die Projektseite mit der Dokumentation nennt dagegen Enterprise-Support im Rahmen einer Lizenz für Couchbase AI Data Plane. Welche Regelung für Sie gilt, klären Sie am besten mit Couchbase. Das Repository wurde zuletzt am 16.10.2026 aktualisiert und ist nicht archiviert; es hat 34 GitHub-Sterne.

Kosten

Der Server selbst ist quelloffen und kostenlos. Kosten können für die Datenbank entstehen: Laut Capella-Dokumentation gibt es einen kostenlosen Operational Cluster zum Einstieg, darüber liegen kostenpflichtige Capella-Pläne, außerdem eine selbst betriebene Server-Variante. Die aktuellen Konditionen finden Sie auf der offiziellen Preisseite von Couchbase; sie konnten bei der Prüfung nicht abgerufen werden und sind hier deshalb nicht im Detail beschrieben.

Für wen lohnt sich der Couchbase MCP Server?

Er lohnt sich für Entwicklungsteams, die Couchbase bereits einsetzen und ihren Assistenten Schema, Abfragen und Indizes verstehen lassen wollen. Wer keine Couchbase-Daten hat, braucht ihn nicht: Der Server ist keine eigene Datenbank, sondern ein Zugang zu einem bestehenden Cluster. Beginnen Sie im Nur-Lese-Modus und mit einem Benutzer, der nur die nötigen Buckets lesen darf.

Ein erreichbarer Couchbase-Cluster (Capella oder selbst betrieben) mit Zugangsdaten, Python 3.10 oder neuer, das Werkzeug uv und ein MCP-Client wie Claude Code oder Cursor.

Mit dem Couchbase MCP Server erkundet ein KI-Assistent Ihren Couchbase-Cluster und stellt SQL++-Abfragen. Dieser Ratgeber führt von den Voraussetzungen bis zur ersten Abfrage.

Schritt 1: Voraussetzungen prüfen

Sie benötigen einen erreichbaren Couchbase-Cluster (Capella oder selbst betrieben), Python 3.10 oder neuer und das Werkzeug uv. Einige Funktionen, etwa die Suchwerkzeuge, setzen laut README Server 7.6 oder neuer voraus.

Eigenen Datenbankbenutzer anlegen

Legen Sie im Cluster einen Benutzer an, der nur die Buckets lesen darf, die der Assistent sehen soll. Die Dokumentation betont, dass die Rechte des Datenbankbenutzers maßgeblich bleiben, auch wenn Werkzeuge im Server abgeschaltet sind.

Schritt 2: In Claude oder Cursor eintragen

Tragen Sie unter mcpServers einen Eintrag mit "command": "uvx" und "args": ["couchbase-mcp-server"] ein. Im Feld env übergeben Sie CB_CONNECTION_STRING, CB_USERNAME und CB_PASSWORD. VS Code verwendet statt mcpServers den Schlüssel servers. Bei selbst betriebenen Clustern mit TLS kommt der Pfad CB_CA_CERT_PATH hinzu.

Nur-Lese-Modus beibehalten

CB_MCP_READ_ONLY_MODE steht standardmäßig auf true: Schreibende Werkzeuge werden nicht geladen, und datenverändernde SQL++-Anweisungen werden blockiert. Schalten Sie das erst ab, wenn der Assistent wirklich Dokumente oder Indizes ändern soll, und prüfen Sie dann CB_MCP_CONFIRMATION_REQUIRED_TOOLS für Rückfragen vor riskanten Werkzeugen.

Als gemeinsamen Dienst betreiben

Statt stdio unterstützt der Server Streamable HTTP über CB_MCP_TRANSPORT, CB_MCP_HOST und CB_MCP_PORT; die Dokumentation beschreibt dafür auch OAuth 2.1. Alternativ nutzen Sie das Docker-Image couchbase/mcp-server.

Schritt 3: Erste Abfragen

Beginnen Sie mit „Welche Buckets, Scopes und Collections gibt es?“ und danach etwa „Zeige die Struktur der Collection orders“ oder „Welche Abfragen laufen am langsamsten?“. Prüfen Sie erzeugte SQL++-Abfragen, bevor Sie Schlüsse daraus ziehen.

uvx couchbase-mcp-server

Benutzername und Passwort des Couchbase-Clusters per Umgebungsvariablen; optional mTLS-Zertifikate und OAuth 2.1 beim Betrieb über Streamable HTTP.

Im Standard nur lesend auf Schema, Dokumente und Abfragen; mit CB_MCP_READ_ONLY_MODE=false auch Schreiben, Löschen und Indexverwaltung im Rahmen der Rechte des Datenbankbenutzers.

Der Server läuft in Ihrer eigenen Umgebung. Abgerufene Dokumente und Abfrageergebnisse gelangen in den Kontext des KI-Clients und damit zum Modellanbieter.

Deaktivierter Nur-Lese-Modus mit weitreichenden Datenbankrechten, Zugangsdaten in der Client-Konfiguration und sensible Dokumente, die an den Modellanbieter gelangen.