Couchbase MCP Server

Čo robí “Couchbase” MCP Server?

Couchbase MCP Server je implementácia Model Context Protocolu (MCP), ktorá umožňuje veľkým jazykovým modelom (LLM) a AI asistentom priamu interakciu s dátami uloženými v Couchbase klastroch. Ako middleware umožňuje plynulú integráciu Couchbase databázových operácií do vývojárskych AI pracovných postupov. Podporuje úlohy ako získanie štruktúry kolekcií, prístup k dokumentom podľa ID, vkladanie alebo mazanie dokumentov a vykonávanie SQL++ dopytov. Prepojením LLM s aktuálnymi Couchbase dátami môžu vývojári automatizovať správu databázy, zvýšiť produktivitu a zjednodušiť komplexné dátové operácie pomocou prirodzeného jazyka. Server je možné nastaviť pre režim len na čítanie alebo aj zápis a je kompatibilný s rôznymi MCP klientmi ako Claude Desktop, Cursor či Windsurf.

Zoznam promptov

V repozitári nie sú uvedené žiadne šablóny promptov.

Zoznam zdrojov

V súboroch repozitára ani README nie sú zdokumentované žiadne explicitné definície zdrojov.

Zoznam nástrojov

• Získať zoznam všetkých scopov a kolekcií: Získajte metadáta o organizácii určeného Couchbase bucketu.
• Získať štruktúru kolekcie: Prístup k štruktúrnym informáciám (schéma) pre zvolenú kolekciu.
• Získať dokument podľa ID: Načítajte dokument z určitého scope a kolekcie podľa jeho unikátneho ID.
• Upsert dokumentu podľa ID: Vložte alebo aktualizujte dokument v zadanom scope a kolekcii.
• Vymazať dokument podľa ID: Odstráňte dokument zo zvoleného scope a kolekcie.
• Spustiť SQL++ dopyt: Vykonajte SQL++ dopyt len na čítanie alebo (voliteľne) so zápisom vo vybranom scope. Štandardne sú modifikačné dopyty pre bezpečnosť vypnuté.

Prípady použitia tohto MCP servera

• Správa databázy: Automatizujte bežné databázové operácie ako pridávanie, úpravu či mazanie dokumentov priamo z AI rozhraní, čím znížite manuálnu záťaž.
• Skúmanie dát: Umožnite vývojárom a AI agentom rýchlo preskúmať dátové štruktúry, kolekcie a obsah dokumentov pre analytiku alebo ladenie.
• Interaktívne dopytovanie: Sprístupnite prirodzené jazykové dopyty, ktoré sa prekladajú do SQL++ a vykonávajú priamo v Couchbase, vďaka čomu je získavanie údajov prístupné aj neodborníkom.
• Automatizované reportovanie: Uľahčite tvorbu dynamických reportov dotazovaním a agregáciou dát cez AI riadené workflowy.
• Bezproblémová integrácia v dev workflowoch: Zvýšte produktivitu integráciou prístupu k Couchbase dátam do nástrojov ako Claude, Cursor či Windsurf a urýchlite kontextovo citlivé kódovanie i dokumentovanie.

Ako to nastaviť

Windsurf

1. Požiadavky: Uistite sa, že je nainštalovaný Python 3.10+ a uv; máte prístup ku Couchbase klastru.
2. Klonujte repozitár:

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

3. Upravte konfiguráciu MCP klienta Windsurf a pridajte Couchbase MCP server:

   {
     "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. Reštartujte Windsurf, aby sa zmeny prejavili.
5. Overte pripojenie spustením testovacieho dopytu.

Claude

1. Požiadavky: Python 3.10+, uv, prístup k Couchbase klastru, nainštalovaný Claude Desktop.
2. Klonujte repozitár Couchbase MCP Server.
3. Nájdite konfiguračný súbor:
   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
4. Pridajte konfiguráciu servera, ako je uvedené vyššie, do sekcie mcpServers.
5. Reštartujte Claude Desktop.
6. Otestujte dotazovaním Couchbase dát cez rozhranie Claude.

Cursor

1. Uistite sa, že máte Python 3.10+, uv a prístup ku Couchbase klastru.
2. Klonujte repozitár a podľa potreby nainštalujte závislosti.
3. Pridajte Couchbase MCP server do konfigurácie Cursor:

   {
     "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. Reštartujte Cursor.
5. Overte spustením databázovej operácie.

Cline

1. Splňte požiadavky: Python 3.10+, uv, Couchbase cluster.
2. Klonujte repozitár lokálne.
3. Pridajte nasledovné do MCP konfigurácie Cline:

   {
     "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. Uložte zmeny a reštartujte Cline.
5. Potvrďte nastavenie vykonaním databázovej akcie.

Zabezpečenie API kľúčov:
Všetky citlivé hodnoty (napr. CB_PASSWORD) sú uložené ako environmentálne premenné v sekcii env konfigurácie.
Príklad:

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

Ako použiť tento MCP vo flowoch

Použitie MCP vo FlowHunt

Na integráciu MCP serverov do svojho FlowHunt workflowu začnite pridaním MCP komponentu do toku a prepojením s AI agentom:

Kliknite na MCP komponent, aby sa otvorila konfiguračná ponuka. V systémovej MCP konfigurácii vložte detaily MCP servera v tomto JSON formáte:

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

Po nastavení môže AI agent používať tento MCP ako nástroj so všetkými jeho funkciami a možnosťami. Nezabudnite zmeniť “couchbase” na skutočný názov vášho MCP servera a URL na adresu vášho MCP servera.

Prehľad

Na základe vyššie uvedených tabuliek je Couchbase MCP Server dobre zdokumentovaný z pohľadu nastavenia a popisu nástrojov, no chýbajú explicitné šablóny promptov, definície zdrojov a dokumentácia k vzorkovaniu/rootom. Jeho využiteľnosť na databázové úlohy je jasná, no mohol by byť rozšírený o viac MCP-native funkcií. Tento MCP server by som ohodnotil 6/10 pre všeobecné použitie s LLM a pre vývojárov.

MCP skóre