🗄️ 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

1. Voraussetzungen

   • Node.js 16 oder höher

   • Eine laufende Couchbase-Instanz auf Capella

   • Claude Desktop-Anwendung

2. Installation

   Der 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

3. Claude Desktop Integration

   Fü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>"
      }
    }
  }
}

4. Verbindung überprüfen

   • Starten Sie Claude Desktop neu

   • Die Couchbase MCP-Servertools sollten jetzt in Ihren Konversationen verfügbar sein

Related MCP server: MCP TapData Server

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

1. Alle Buckets auflisten:

   Could you show me all available buckets in the database?

2. Erstellen Sie einen Bereich und eine Sammlung:

   Create a new scope called "users" and a collection called "profiles" in it

3. Dokumente abfragen:

   Find all users who signed up in the last 30 days

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

🛡️ Sicherheitsbewertungsabzeichen (MseeP.ai)