Couchbase

Couchbase MCP Server

Couchbase MCP Server ist ein selbst gehosteter MCP-Server, der es KI-Agenten ermöglicht, sich mit Daten in Couchbase-Clustern zu verbinden und mit ihnen zu interagieren, egal ob sie auf Capella oder selbstverwaltet gehostet werden. Er bietet Tools in den Kategorien Cluster-Health, Datenschema, Key-Value, Query und Performance – mit Sicherheitskontrollen über den Nur-Lese-Modus und die feingranulare Deaktivierung von Tools. Er unterstützt sowohl STDIO- als auch Streamable-HTTP-Transports.

Couchbase MCP Server wird als Python Package Index (PyPI)-Paket und über Docker verteilt. Enterprise-Support für Couchbase MCP Server ist durch die Lizenzierung von Couchbase AI Data Plane verfügbar, die auch die Nutzung und den Enterprise-Support von Couchbase Agent Memory und Couchbase Agent Catalog umfasst.

Für die vollständige Dokumentation besuchen Sie mcp-server.couchbase.com.

Funktionen/Tools

Cluster-Setup- und Health-Tools

Datenmodell- und Schema-Erkennungstools

Dokument-KV-Operationstools

Query- und Indizierungstools

Tools zur Analyse der Abfrageleistung

Voraussetzungen

• Python 3.10 oder höher.
• Ein laufender Couchbase-Cluster. Der einfachste Einstieg ist die Nutzung des Capella Free-Tiers, der eine vollständig verwaltete Version des Couchbase-Servers ist. Sie können den Anweisungen folgen, um einen der Beispieldatensätze zu importieren oder eigene Daten zu importieren.
• uv installiert, um den Server auszuführen.
• Ein MCP-Client wie Claude Desktop installiert, um den Server mit Claude zu verbinden. Die Anweisungen werden für Claude Desktop und Cursor bereitgestellt. Andere MCP-Clients können ebenfalls verwendet werden.

Konfiguration

Der MCP-Server kann entweder aus dem vorgefertigten PyPI-Paket oder aus dem Quellcode mit uv ausgeführt werden.

Ausführen von PyPI

Wir veröffentlichen ein vorgefertigtes PyPI-Paket für den MCP-Server.

Serverkonfiguration mit vorgefertigtem Paket für MCP-Clients

Basisauthentifizierung

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": ["couchbase-mcp-server"],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_USERNAME": "username",
        "CB_PASSWORD": "password"
      }
    }
  }
}

oder

mTLS

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": ["couchbase-mcp-server"],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_CLIENT_CERT_PATH": "/path/to/client-certificate.pem",
        "CB_CLIENT_KEY_PATH": "/path/to/client.key"
      }
    }
  }
}

Hinweis: Wenn Sie andere MCP-Server im Client verwenden, können Sie ihn zum vorhandenen mcpServers-Objekt hinzufügen.

Ausführen aus dem Quellcode

Der MCP-Server kann aus dem Quellcode mit diesem Repository ausgeführt werden.

Klonen Sie das Repository auf Ihren lokalen Rechner

git clone https://github.com/couchbase/mcp-server-couchbase.git

Serverkonfiguration mit Quellcode für MCP-Clients

Dies ist die übliche Konfiguration für MCP-Clients wie Claude Desktop, Cursor, Windsurf Editor.

{
  "mcpServers": {
    "couchbase": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/cloned/repo/mcp-server-couchbase/",
        "run",
        "src/mcp_server.py"
      ],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_USERNAME": "username",
        "CB_PASSWORD": "password"
      }
    }
  }
}

Hinweis: path/to/cloned/repo/mcp-server-couchbase/ sollte der Pfad zum geklonten Repository auf Ihrem lokalen Rechner sein. Vergessen Sie nicht den abschließenden Schrägstrich am Ende!

Hinweis: Wenn Sie andere MCP-Server im Client verwenden, können Sie ihn zum vorhandenen mcpServers-Objekt hinzufügen.

Zusätzliche Konfiguration für den MCP-Server

Der Server kann mithilfe von Umgebungsvariablen oder Befehlszeilenargumenten konfiguriert werden:

Konfiguration des Nur-Lese-Modus

CB_MCP_READ_ONLY_MODE ist der einzige Schalter, der Schreiboperationen steuert:

• Wenn true (Standard): Alle Schreiboperationen (KV, Query, Scope-/Collection-Verwaltung und Indexverwaltung) sind deaktiviert. KV-Schreibtools (upsert, insert, replace, delete, sub-document mutate), Scope-/Collection-Verwaltungsschreibtools (create_scope, create_collection, delete_scope, delete_collection) und Index-Schreibtools (create_index, build_index, drop_index) sind nicht geladen und stehen dem LLM nicht zur Verfügung, und SQL++-Abfragen, die Daten oder Strukturen ändern, werden blockiert.
• Wenn false: KV-, Scope-/Collection-Verwaltungs- und Index-Schreibtools sind geladen und SQL++-Abfragen zur Daten-/Strukturänderung sind erlaubt.

Dies ist die empfohlene sichere Standardeinstellung, um unbeabsichtigte Datenänderungen durch LLMs zu verhindern.

Hinweis: Für die Authentifizierung benötigen Sie entweder den Benutzernamen und das Passwort oder das Client-Zertifikat und die Schlüsselpfade. Optional können Sie den CA-Root-Zertifikatspfad angeben, der zur Validierung der Serverzertifikate verwendet wird. Wenn sowohl der Client-Zertifikat- und Schlüsselpfad als auch Benutzername und Passwort angegeben sind, werden die Client-Zertifikate für die Authentifizierung verwendet.

Deaktivieren von Tools

Sie können bestimmte Tools deaktivieren, um zu verhindern, dass sie geladen und dem MCP-Client ausgesetzt werden. Deaktivierte Tools erscheinen nicht in der Tool-Erkennung und können nicht vom LLM aufgerufen werden.

Unterstützte Formate

Kommagetrennte Liste:

# Environment variable
CB_MCP_DISABLED_TOOLS="upsert_document_by_id, delete_document_by_id"

# Command line
uvx couchbase-mcp-server --disabled-tools upsert_document_by_id, delete_document_by_id

Dateipfad (ein Toolname pro Zeile):

# Environment variable
CB_MCP_DISABLED_TOOLS=disabled_tools.txt

# Command line
uvx couchbase-mcp-server --disabled-tools disabled_tools.txt

Dateiformat (z.B. disabled_tools.txt):

# Write operations
upsert_document_by_id
delete_document_by_id

# Index advisor
get_index_advisor_recommendations

Zeilen, die mit # beginnen, werden als Kommentare behandelt und ignoriert.

MCP-Client-Konfigurationsbeispiele

Verwendung einer Kommagetrennten Liste:

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": ["couchbase-mcp-server"],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_USERNAME": "username",
        "CB_PASSWORD": "password",
        "CB_MCP_DISABLED_TOOLS": "upsert_document_by_id,delete_document_by_id"
      }
    }
  }
}

Verwendung eines Dateipfads (empfohlen für viele Tools):

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": ["couchbase-mcp-server"],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_USERNAME": "username",
        "CB_PASSWORD": "password",
        "CB_MCP_DISABLED_TOOLS": "/path/to/disabled_tools.txt"
      }
    }
  }
}

Wichtiger Sicherheitshinweis

Warnung: Das alleinige Deaktivieren von Tools garantiert nicht, dass bestimmte Operationen nicht ausgeführt werden können. Die RBAC-Berechtigungen (Role-Based Access Control) des zugrunde liegenden Datenbankbenutzers sind die maßgebliche Sicherheitskontrolle.

Wenn Sie beispielsweise upsert_document_by_id und delete_document_by_id deaktivieren, können Datenänderungen weiterhin über das Tool run_sql_plus_plus_query mit SQL++-DML-Anweisungen (INSERT, UPDATE, DELETE, MERGE) erfolgen, sofern nicht:

• CB_MCP_READ_ONLY_MODE auf true gesetzt ist (Standard), ODER
• Der Datenbankbenutzer nicht über die erforderlichen RBAC-Berechtigungen für Datenänderungen verfügt

Bewährte Praxis: Konfigurieren Sie immer angemessene RBAC-Berechtigungen für Ihre Couchbase-Benutzerdaten als primäre Sicherheitsmaßnahme. Verwenden Sie die Deaktivierung von Tools als zusätzliche Ebene, um das LLM-Verhalten zu steuern und die Angriffsfläche zu verringern, nicht als alleinige Sicherheitskontrolle.

Elicitation/Bestätigung für Tool-Aufrufe

Sie können für bestimmte Tools vor der Ausführung eine explizite Benutzerbestätigung verlangen (wenn der MCP-Client Elicitation unterstützt).

CB_MCP_CONFIRMATION_REQUIRED_TOOLS / --confirmation-required-tools unterstützt diese Formate:

• Kommagetrennte Liste
• Dateipfad (ein Toolname pro Zeile, #-Kommentare unterstützt)

Beispiel:

# Environment variable
CB_MCP_CONFIRMATION_REQUIRED_TOOLS="delete_document_by_id,replace_document_by_id"

# Command line
uvx couchbase-mcp-server --confirmation-required-tools delete_document_by_id,replace_document_by_id

Wenn ein aufgelistetes Tool aufgerufen wird:

• Wenn der Client Elicitation unterstützt, wird der Benutzer zur Bestätigung aufgefordert.
• Wenn der Client keine Elicitation unterstützt, wird das Tool ohne Bestätigung ausgeführt, um Abwärtskompatibilität zu gewährleisten.

Sie können auch die Version des Servers überprüfen mit:

uvx couchbase-mcp-server --version

Protokollierung

Der MCP-Server protokolliert standardmäßig in stderr. Die Protokollierung wird mit den CB_MCP_LOG_*-Variablen konfiguriert, die in Zusätzliche Konfiguration aufgeführt sind:

• CB_MCP_LOG_LEVEL — wie viel protokolliert wird: info (Standard) protokolliert Lebenszyklus-Ereignisse und Tool-Aufrufe, debug fügt ausführliche interne Details hinzu, und off deaktiviert die gesamte Protokollierung.
• CB_MCP_LOG_SINKS — wohin Protokolle gehen: stderr (Standard), rotierende Dateien pro Ebene (file) oder beides. Mit file wird pro Ebene eine Datei geschrieben (z.B. mcp_server.info.log und mcp_server.error.log) am Pfad, der von CB_MCP_LOG_FILE festgelegt wird.
• Rotationsgröße — CB_MCP_LOG_ROTATION_MAX_SIZE_MB ist die globale Größe (in MB), bei der jede Datei pro Ebene rotiert. Überschreiben Sie einzelne Ebenen mit CB_MCP_LOG_<LEVEL>_ROTATION_MAX_SIZE_MB (ERROR/WARNING/INFO/DEBUG), ebenfalls in MB, die den globalen Wert erben, wenn nicht gesetzt. Eine Größe von 0 (global oder pro Ebene) ist ungültig und fällt mit einer Startwarnung auf den Standardwert (1 MB) zurück. CB_MCP_LOG_MAX_BYTES (Bytes) ist veraltet, wird aber aus Gründen der Abwärtskompatibilität weiterhin unterstützt; es wird ignoriert, wenn CB_MCP_LOG_ROTATION_MAX_SIZE_MB ebenfalls gesetzt ist, und gibt beim Start eine Veraltungs-Warnung aus.
• Aufbewahrung — CB_MCP_LOG_RETENTION_BACKUP_COUNT legt fest, wie viele rotierte Sicherungen pro Ebene aufbewahrt werden (ohne die aktive Datei); der Standardwert von 1 erhält das bisherige Verhalten. Überschreiben Sie einzelne Ebenen mit CB_MCP_LOG_<LEVEL>_RETENTION_BACKUP_COUNT (ERROR/WARNING/INFO/DEBUG), die den globalen Wert erben, wenn nicht gesetzt. Setzen Sie eine Anzahl auf 0, um nur die aktive Datei für diese Ebene zu behalten — sie ist weiterhin durch die Rotationsgröße begrenzt (beim Überlauf zurückgesetzt statt gesichert).
• Serverkonfigurations-Snapshot — wenn die file-Senke aktiv ist, wird ein einmaliger Datensatz (OS, Python, Abhängigkeitsversionen, Transport, aufgelöste Protokollierungskonfiguration und geschwärzte Serverkonfiguration) als JSON in eine dedizierte mcp_server_config.log.json-Datei geschrieben (abgeleitet von der CB_MCP_LOG_FILE-Basis). Sie wird bei jedem Start überschrieben, sodass der Support immer die aktuelle Konfiguration hat und sie nie aus einem rotierenden Protokoll herausrollt.

# Enable debug logging to both stderr and rotating per-level files
uvx couchbase-mcp-server --log-level=debug --log-sinks=stderr,file

# Keep 30 rotated ERROR backups but only the live DEBUG file
uvx couchbase-mcp-server --log-level=debug --log-sinks=file \
  --log-error-retention-backup-count=30 --log-debug-retention-backup-count=0

Weitere Details finden Sie in der Dokumentation.

Clientspezifische Konfiguration

Streamable-HTTP-Transportmodus

Der MCP-Server kann im Streamable-HTTP-Transportmodus ausgeführt werden, der es mehreren Clients ermöglicht, sich über HTTP mit derselben Serverinstanz zu verbinden. Überprüfen Sie, ob Ihr MCP-Client den Streamable-HTTP-Transport unterstützt, bevor Sie versuchen, sich in diesem Modus mit dem MCP-Server zu verbinden.

Hinweis: OAuth-2.1-Autorisierung wird bei diesem Transport unterstützt. Siehe OAuth-2.1-Autorisierung. Ohne konfiguriertes OAuth ist der HTTP-Endpunkt nicht authentifiziert.

Verwendung

Standardmäßig läuft der MCP-Server auf Port 8000, dies kann jedoch über die Umgebungsvariable --port oder CB_MCP_PORT konfiguriert werden.

uvx couchbase-mcp-server \
  --connection-string='<couchbase_connection_string>' \
  --username='<database_username>' \
  --password='<database_password>' \
  --read-only-mode=true \
  --transport=http

Der Server ist unter http://localhost:8000/mcp verfügbar. Dies kann in MCP-Clients verwendet werden, die den Streamable-HTTP-Transportmodus unterstützen, wie z. B. Cursor.

MCP-Client-Konfiguration

{
  "mcpServers": {
    "couchbase-http": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

SSE-Transportmodus

Es gibt die Option, den MCP-Server im Server-Sent-Events (SSE)-Transportmodus auszuführen.

Hinweis: Der SSE-Modus wurde von MCP veraltet. Wir unterstützen Streamable-HTTP.

SSE: Verwendung

Standardmäßig läuft der MCP-Server auf Port 8000, dies kann jedoch über die Umgebungsvariable --port oder CB_MCP_PORT konfiguriert werden.

uvx couchbase-mcp-server \
  --connection-string='<couchbase_connection_string>' \
  --username='<database_username>' \
  --password='<database_password>' \
  --read-only-mode=true \
  --transport=sse

Der Server ist unter http://localhost:8000/sse verfügbar. Dies kann in MCP-Clients verwendet werden, die den SSE-Transportmodus unterstützen, wie z. B. Cursor.

SSE: MCP-Client-Konfiguration

{
  "mcpServers": {
    "couchbase-sse": {
      "url": "http://localhost:8000/sse"
    }
  }
}

OAuth-2.1-Autorisierung

Wenn der Server mit --transport=http ausgeführt wird, kann er als OAuth-2.1-Ressourcenserver fungieren: Er validiert eingehende Bearer-JWTs gegen das JWKS Ihres Identitätsanbieters. Er ist anbieterunabhängig (jeder OAuth-2.1-/OIDC-Anbieter, der ein JWKS veröffentlicht – Auth0, Okta, Keycloak, AWS Cognito, Microsoft Entra usw.) und gibt keine Token aus und verwaltet keine Benutzer. OAuth-Einstellungen werden bei stdio ignoriert.

OAuth wird mit den CB_MCP_OAUTH_*-Variablen konfiguriert, die in Zusätzliche Konfiguration aufgeführt sind:

• OAuth wird nur aktiviert, wenn alle drei von CB_MCP_OAUTH_JWT_JWKS_URI, CB_MCP_OAUTH_JWT_ISSUER und CB_MCP_OAUTH_JWT_AUDIENCE gesetzt sind; wenn nur einige davon gesetzt sind, schlägt der Start fehl.
• Das Setzen von CB_MCP_OAUTH_MCP_BASE_URL veröffentlicht zusätzlich RFC-9728-Protected-Resource-Metadaten, sodass PRM-fähige Clients den Autorisierungsserver entdecken können.
• Der Zugriff wird durch zwei Bereiche gesteuert, die aus dem scope/scp-Anspruch des Tokens gelesen werden: couchbase-mcp:read (Lesetools, einschließlich SQL++) und couchbase-mcp:write (Schreibtools: KV-Mutationen, Scope-/Collection-Verwaltung und Indexverwaltung). Für den vollständigen Zugriff sind beide erforderlich. Wenn Ihr IdP diese kanonischen Bezeichnungen nicht ausgeben kann, überschreiben Sie sie mit CB_MCP_OAUTH_SCOPE_READ_LABEL / CB_MCP_OAUTH_SCOPE_WRITE_LABEL.

uvx couchbase-mcp-server \
  --connection-string='<couchbase_connection_string>' \
  --username='<database_username>' \
  --password='<database_password>' \
  --transport=http \
  --oauth-jwks-uri='https://auth.example.com/.well-known/jwks.json' \
  --oauth-issuer='https://auth.example.com/' \
  --oauth-audience='couchbase-mcp-server' \
  --oauth-mcp-base-url='<public_base_url_of_this_server>'

Weitere Details finden Sie in der Dokumentation.

Docker-Image

Der MCP-Server kann auch als Docker-Container erstellt und ausgeführt werden. Vorgefertigte Images finden Sie auf DockerHub oder können über docker pull docker.io/couchbase/mcp-server:latest bezogen werden.

Alternativ sind wir Teil des Docker-MCP-Katalogs.

Image erstellen

docker build -t mcp/couchbase-src .

docker build --build-arg GIT_COMMIT_HASH=$(git rev-parse HEAD) \
  --build-arg BUILD_DATE=$(date -u +'%Y-%m-%dT%H:%M:%SZ') \
  -t mcp/couchbase-src .

# Build with default image name (mcp/couchbase-src)
./build.sh

# Build with custom image name
./build.sh my-custom/image-name

# View git commit hash in image
docker inspect --format='{{index .Config.Labels "org.opencontainers.image.revision"}}' mcp/couchbase-src:latest

# View all metadata labels
docker inspect --format='{{json .Config.Labels}}' mcp/couchbase-src:latest

Ausführen

Der MCP-Server kann mit den Umgebungsvariablen ausgeführt werden, die zur Konfiguration der Couchbase-Einstellungen verwendet werden. Die Umgebungsvariablen sind dieselben wie im Abschnitt „Zusätzliche Konfiguration“ beschrieben.

Unabhängiger Docker-Container

docker run --rm -i \
  -e CB_CONNECTION_STRING='<couchbase_connection_string>' \
  -e CB_USERNAME='<database_user>' \
  -e CB_PASSWORD='<database_password>' \
  -e CB_MCP_TRANSPORT='<http|sse|stdio>' \
  -e CB_MCP_READ_ONLY_MODE='<true|false>' \
  -e CB_MCP_CONFIRMATION_REQUIRED_TOOLS='delete_document_by_id' \
  -e CB_MCP_PORT=9001 \
  -e CB_MCP_HOST=0.0.0.0 \
  -p 9001:9001 \
  mcp/couchbase-src

Die Umgebungsvariablen CB_MCP_PORT und CB_MCP_HOST gelten nur bei HTTP-Transportmodi wie http und sse.

Docker: MCP-Client-Konfiguration

Das Docker-Image kann im stdio-Transportmodus mit der folgenden Konfiguration verwendet werden.

{
  "mcpServers": {
    "couchbase-mcp-docker": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "CB_CONNECTION_STRING=<couchbase_connection_string>",
        "-e",
        "CB_USERNAME=<database_user>",
        "-e",
        "CB_PASSWORD=<database_password>",
        "mcp/couchbase-src"
      ]
    }
  }
}

Hinweise

• Der Wert von couchbase_connection_string hängt davon ab, ob der Couchbase-Server auf demselben Host-Rechner, in einem anderen Docker-Container oder auf einem entfernten Host läuft. Wenn Ihr Couchbase-Server auf Ihrem Host-Rechner läuft, hat Ihre Verbindungszeichenfolge wahrscheinlich die Form couchbase://host.docker.internal. Details finden Sie in der Docker-Dokumentation.
• Sie können die Netzwerkkonfiguration des Containers über die Option --network=<your_network> festlegen. Das von Ihnen gewählte Netzwerk hängt von Ihrer Umgebung ab; der Standard ist bridge. Details finden Sie unter Netzwerktreiber in Docker.

Risiken im Zusammenhang mit LLMs

• Die Verwendung großer Sprachmodelle und ähnlicher Technologien birgt Risiken, einschließlich der Möglichkeit ungenauer oder schädlicher Ausgaben.
• Couchbase überprüft oder bewertet nicht die Qualität oder Genauigkeit solcher Ausgaben, und solche Ausgaben spiegeln möglicherweise nicht die Ansichten von Couchbase wider.
• Sie sind allein dafür verantwortlich, zu entscheiden, ob Sie große Sprachmodelle und verwandte Technologien verwenden, und alle Lizenzbedingungen, Nutzungsbedingungen und Richtlinien Ihrer Organisation für deren Verwendung einzuhalten.

Erfassung von Nutzungsdaten

Dieses Produkt erfasst automatisch Nutzungs- und Leistungsdaten (wie Produktname und -version) sowie Browserinformationen (wie IP-Adresse) (zusammen „Nutzungsdaten“). Couchbase verwendet Nutzungsdaten zusammen mit anderen Daten, die Sie Couchbase möglicherweise zur Verfügung stellen (wie Ihren Benutzernamen oder Ihre E-Mail-Adresse), um unsere Produkte zu entwickeln und zu verbessern sowie unsere Vertriebs- und Marketingprogramme zu informieren. Wir greifen nicht auf Daten zu, die Sie in Couchbase-Produkten speichern, und sammeln diese auch nicht. Wir verwenden Nutzungsdaten, um aggregierte Nutzungsmuster zu verstehen und unsere Produkte für Sie nützlicher zu machen. Weitere Informationen darüber, wie Couchbase Informationen erfasst, schützt und verarbeitet, finden Sie in der Couchbase-Datenschutzrichtlinie unter https://www.couchbase.com/privacy-policy.

Tipps zur Fehlerbehebung

• Stellen Sie sicher, dass der Pfad zu Ihrem MCP-Server-Repository in der Konfiguration korrekt ist, wenn Sie aus dem Quellcode ausführen.
• Überprüfen Sie, dass Ihre Couchbase-Verbindungszeichenfolge, der Datenbank-Benutzername, das Passwort oder der Pfad zu den Zertifikaten korrekt sind.
• Wenn Sie Couchbase Capella verwenden, stellen Sie sicher, dass der Cluster von der Maschine, auf der der MCP-Server läuft, zugänglich ist.
• Überprüfen Sie, dass der Datenbank-Benutzer über die entsprechenden Berechtigungen verfügt, um auf mindestens einen Bucket zuzugreifen.
• Bestätigen Sie, dass der Paketmanager uv ordnungsgemäß installiert und zugänglich ist. Möglicherweise müssen Sie den absoluten Pfad zu uv/uvx im Feld command in der Konfiguration angeben.
• Überprüfen Sie die Protokolle auf Fehler oder Warnungen, die auf Probleme mit dem MCP-Server hinweisen könnten. Der Speicherort der Protokolle hängt von Ihrem MCP-Client ab.
• Wenn Sie Probleme beim Ausführen Ihres MCP-Servers aus dem Quellcode feststellen, nachdem Sie Ihr lokales MCP-Server-Repository aktualisiert haben, versuchen Sie, uv sync auszuführen, um die Abhängigkeiten zu aktualisieren.

Integrationstests

Wir bieten hochrangige MCP-Integrationstests an, um zu überprüfen, dass der Server die erwarteten Tools bereitstellt und dass sie gegen einen Demo-Couchbase-Cluster aufgerufen werden können.

1. Exportieren Sie die Anmeldeinformationen für den Demo-Cluster:
   • CB_CONNECTION_STRING
   • CB_USERNAME
   • CB_PASSWORD
   • Optional: CB_MCP_TEST_BUCKET (ein Bucket, der während der Tests überprüft werden soll)
2. Führen Sie die Tests aus:

uv run pytest tests/ -v

👩‍💻 Beitragen

Wir begrüßen Beiträge aus der Community! Ob Sie Fehler beheben, Funktionen hinzufügen oder die Dokumentation verbessern möchten, Ihre Hilfe wird geschätzt.

Wenn Sie Hilfe benötigen, einen Fehler gefunden haben oder Verbesserungen beitragen möchten, ist der beste Ort dafür genau hier – indem Sie ein GitHub-Issue öffnen.

Für Entwickler

Wenn Sie daran interessiert sind, Code beizutragen oder eine Entwicklungsumgebung einzurichten:

📖 Siehe CONTRIBUTING.md für umfassende Anweisungen zur Entwicklungsumgebung, einschließlich:

• Einrichtung der Entwicklungsumgebung mit uv
• Code-Linting und -Formatierung mit Ruff
• Installation von Pre-commit-Hooks
• Überblick über die Projektstruktur
• Entwicklungsworkflow und -praktiken

Schnellstart für Mitwirkende

# Clone and setup
git clone https://github.com/couchbase/mcp-server-couchbase.git
cd mcp-server-couchbase

# Install with development dependencies
uv sync --extra dev

# Install pre-commit hooks
uv run pre-commit install

# Run linting
./scripts/lint.sh

📢 Support-Richtlinie

Wir schätzen Ihr Interesse an diesem Projekt sehr!

Dieses Projekt wird von der Couchbase-Community gepflegt, was bedeutet, dass es nicht offiziell unterstützt wird von unserem Support-Team. Unsere Ingenieure überwachen und pflegen dieses Repository jedoch aktiv und werden versuchen, Probleme nach bestem Bemühen zu lösen.

Unser Support-Portal kann bei Anfragen zu diesem Projekt nicht helfen, daher bitten wir Sie freundlich, alle Anfragen innerhalb von GitHub zu halten.

Ihre Zusammenarbeit hilft uns allen, gemeinsam voranzukommen – vielen Dank!