Couchbase MCP Server

Hvad gør “Couchbase” MCP Server?

Couchbase MCP Server er en implementering af Model Context Protocol (MCP), der gør det muligt for Large Language Models (LLM’er) og AI-assistenter at interagere direkte med data lagret i Couchbase-klynger. Som middleware muliggør denne server problemfri integration af Couchbase-databaseoperationer i AI-drevne udviklingsarbejdsgange. Den understøtter opgaver som at hente strukturen for kollektioner, tilgå dokumenter via ID, opdatere eller slette dokumenter samt udføre SQL++-forespørgsler. Ved at forbinde LLM’er til live Couchbase-data kan udviklere automatisere databaseadministration, øge produktiviteten og strømline komplekse dataoperationer via naturlige sproggrænseflader. Serveren kan konfigureres til kun læsning eller læse-/skrivetilstand og er kompatibel med forskellige MCP-klienter som Claude Desktop, Cursor og Windsurf.

Liste over prompts

Ingen information om promptskabeloner er angivet i repositoriet.

Liste over ressourcer

Ingen eksplicitte ressource-definitioner er dokumenteret i repositoriets filer eller README.

Liste over værktøjer

• Få en liste over alle scopes og kollektioner: Hent metadata om organiseringen af en angivet Couchbase-bucket.
• Få strukturen for en kollektion: Tilgå strukturel information (skema) for en given kollektion.
• Hent et dokument via ID: Hent et dokument fra en specificeret scope og kollektion ved hjælp af dets unikke ID.
• Upsert et dokument via ID: Indsæt eller opdatér et dokument i en given scope og kollektion.
• Slet et dokument via ID: Fjern et dokument fra en specificeret scope og kollektion.
• Kør en SQL++-forespørgsel: Udfør en SQL++-forespørgsel med kun læse- eller (valgfrit) skriveadgang mod en angiven scope. Som standard er forespørgsler, der ændrer data, deaktiveret af sikkerhedshensyn.

Anvendelsesområder for denne MCP Server

• Databaseadministration: Automatisér almindelige databaseoperationer som tilføjelse, opdatering eller sletning af dokumenter direkte fra AI-grænseflader og reducer det manuelle arbejde.
• Dataudforskning: Giv udviklere og AI-agenter mulighed for hurtigt at udforske datastrukturer, kollektioner og dokumentindhold til analyse eller fejlsøgning.
• Interaktive forespørgsler: Muliggør naturlige sprogforespørgsler, der oversættes til SQL++ og udføres på Couchbase, hvilket gør dataudtræk tilgængeligt for ikke-eksperter.
• Automatiseret rapportering: Understøt generering af dynamiske rapporter ved at forespørge og aggregere data gennem AI-drevne arbejdsgange.
• Problemfri integration i udviklingsarbejdsgange: Forøg produktiviteten ved at integrere Couchbase-datadgang i værktøjer som Claude, Cursor eller Windsurf og strømline kontekstafhængig kodning og dokumentationsopgaver.

Sådan sættes det op

Windsurf

1. Forudsætninger: Sørg for, at Python 3.10+ og uv er installeret; hav adgang til en Couchbase-klynge.
2. Klon repositoriet:

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

3. Rediger Windsurf MCP-klientkonfigurationen til at inkludere Couchbase MCP-serveren:

   {
     "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",
           "CB_BUCKET_NAME": "bucket_name"
         }
       }
     }
   }
   

4. Genstart Windsurf for at anvende ændringerne.
5. Verificér forbindelsen ved at køre en testforespørgsel.

Claude

1. Forudsætninger: Python 3.10+, uv, adgang til Couchbase-klynge, Claude Desktop installeret.
2. Klon Couchbase MCP Server-repositoriet.
3. Find konfigurationsfilen:
   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
4. Tilføj serverkonfigurationen som vist ovenfor til mcpServers-sektionen.
5. Genstart Claude Desktop.
6. Test ved at forespørge Couchbase-data via Claude-grænsefladen.

Cursor

1. Sørg for, at Python 3.10+, uv og adgang til en Couchbase-klynge er på plads.
2. Klon repoet og installer eventuelle afhængigheder.
3. Tilføj Couchbase MCP-serveren til Cursors konfiguration:

   {
     "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",
           "CB_BUCKET_NAME": "bucket_name"
         }
       }
     }
   }
   

4. Genstart Cursor.
5. Verificér ved at udføre en databaseoperation.

Cline

1. Opfyld forudsætningerne: Python 3.10+, uv, Couchbase-klynge.
2. Klon repositoriet lokalt.
3. Tilføj følgende til Clines MCP-konfiguration:

   {
     "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",
           "CB_BUCKET_NAME": "bucket_name"
         }
       }
     }
   }
   

4. Gem ændringerne og genstart Cline.
5. Bekræft opsætningen ved at udføre en databasehandling.

Sikring af API-nøgler:
Alle følsomme værdier (f.eks. CB_PASSWORD) gemmes som miljøvariabler i konfigurationens env-sektion.
Eksempel:

"env": {
  "CB_CONNECTION_STRING": "couchbases://connection-string",
  "CB_USERNAME": "username",
  "CB_PASSWORD": "password",
  "CB_BUCKET_NAME": "bucket_name"
}

Sådan bruges denne MCP i flows

Brug af MCP i FlowHunt

For at integrere MCP-servere i dit FlowHunt-arbejdsflow skal du starte med at tilføje MCP-komponenten til dit flow og forbinde den til din AI-agent:

Klik på MCP-komponenten for at åbne konfigurationspanelet. I systemets MCP-konfigurationssektion indsættes dine MCP-serveroplysninger i dette JSON-format:

{ “couchbase”: { “transport”: “streamable_http”, “url”: “https://yourmcpserver.example/pathtothemcp/url" } }

Når det er konfigureret, kan AI-agenten nu bruge denne MCP som et værktøj med adgang til alle dens funktioner og muligheder. Husk at ændre “couchbase” til det faktiske navn på din MCP-server og udskift URL’en med din egen MCP-server-URL.

Oversigt

På baggrund af ovenstående tabeller er Couchbase MCP Server veldokumenteret med hensyn til opsætning og værktøjer, men mangler eksplicitte promptskabeloner, ressourcedefinitioner og dokumentation for sampling/roots-support. Dens nytte for databasetasks er klar, men den kunne forbedres med flere MCP-native funktioner. Jeg vil vurdere denne MCP-server til 6/10 for generel LLM- og udviklerbrug.

MCP-score