Couchbase MCP Server für LLMs

🗄️ Couchbase MCP Server für LLMs

Ein Model Context Protocol (MCP)-Server, der LLMs die direkte Interaktion mit Couchbase-Datenbanken auf Capella-Clustern ermöglicht. Abfragen von Buckets, Ausführen von CRUD-Operationen, Ausführen von N1QL-Abfragen und nahtlose Datenverwaltung mithilfe natürlicher Sprache.

🚀 Schnellstart

Voraussetzungen
- Node.js 16 oder höher
- Eine laufende Couchbase-Instanz auf Capella
- Claude Desktop-Anwendung
InstallationDer Couchbase MCP-Server kann auf zwei Arten installiert werden:

Option 1: Verwenden von NPX (empfohlen)

Der schnellste Einstieg erfolgt über NPX:

npx -y @couchbasedatabase/couchbase-mcp

Option 2: Manuelle Installation

Wenn Sie das Projekt lieber manuell klonen und ausführen möchten:

# Clone the repository
git clone https://github.com/Aniket310101/MCP-Server-Couchbase.git
cd MCP-Server-Couchbase

# Install dependencies
npm install

# Build the project
npm run build

Claude Desktop IntegrationFügen Sie diese Konfiguration zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:Windows : %APPDATA%/Claude/claude_desktop_config.json
MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json

Option 1: Mit Paketinstallation

{
  "mcpServers": {
    "couchbase": {
      "command": "npx",
      "args": ["-y", "@couchbasedatabase/couchbase-mcp"],
      "env": {
        "COUCHBASE_URL": "<COUCHBASE CONNECTION STRING>",
        "COUCHBASE_BUCKET": "<BUCKET NAME>",
        "COUCHBASE_USERNAME": "<COUCHBASE USERNAME>",
        "COUCHBASE_PASSWORD": "<COUCHBASE PASSWORD>"
      }
    }
  }
}

Option 2: Mit manueller Installation

{
  "mcpServers": {
    "couchbase": {
      "command": "node",
      "args": ["path/to/MCP-Server-Couchbase/dist/index.js"],
      "env": {
        "COUCHBASE_URL": "<COUCHBASE CONNECTION STRING>",
        "COUCHBASE_BUCKET": "<BUCKET NAME>",
        "COUCHBASE_USERNAME": "<COUCHBASE USERNAME>",
        "COUCHBASE_PASSWORD": "<COUCHBASE PASSWORD>"
      }
    }
  }
}

Verbindung überprüfen
- Starten Sie Claude Desktop neu
- Die Couchbase MCP-Servertools sollten jetzt in Ihren Konversationen verfügbar sein

📝 Verfügbare Tools

Grundlegende Operationen

query : Führen Sie N1QL-Abfragen aus
listBuckets : Listet verfügbare Buckets auf

Umfangsmanagement

createScope : Erstellen Sie einen neuen Bereich in einem Bucket
deleteScope : Löscht einen vorhandenen Bereich
listScopes : Listet alle Bereiche in einem Bucket auf

Sammlungsverwaltung

createCollection : Erstellen Sie eine neue Sammlung in einem Bereich
dropCollection : Löschen Sie eine Sammlung aus einem Bereich

Dokumentvorgänge

createDocument : Erstellt ein neues Dokument
getDocument : Ruft ein Dokument anhand der ID ab
updateDocument : Aktualisieren Sie ein vorhandenes Dokument
deleteDocument : Löscht ein Dokument anhand der ID
bulkCreateDocuments : Mehrere Dokumente gleichzeitig erstellen

Indexverwaltung

createIndex : Erstellen Sie einen neuen Index für angegebene Felder
createPrimaryIndex : Erstellen Sie einen Primärindex für eine Sammlung
listIndexes : Listet alle Indizes in einem Bucket auf
dropIndex : Löscht einen vorhandenen Index

Jedes Tool unterstützt optionale collection und scope zum Ansprechen bestimmter Datencontainer.

🔒 Sicherheitsüberlegungen

Verwenden Sie für vertrauliche Anmeldeinformationen immer Umgebungsvariablen
Erwägen Sie, den Server für den Produktionseinsatz hinter einem Reverse-Proxy auszuführen
Implementieren Sie bei Bedarf entsprechende Zugriffskontrollen und Authentifizierung

📚 Beispiele

Hier sind einige Beispiele für Interaktionen mit Claude über den MCP-Server:

Alle Buckets auflisten:
Could you show me all available buckets in the database?
Erstellen Sie einen Bereich und eine Sammlung:
Create a new scope called "users" and a collection called "profiles" in it
Dokumente abfragen:
Find all users who signed up in the last 30 days
Erstellen Sie ein Dokument:
Create a new user document with name "John Doe" and email "john@example.com"

🤝 Beitrag

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

Couchbase MCP Server for LLMs

Integrations