Couchbase MCP Server

K čemu slouží “Couchbase” MCP Server?

Couchbase MCP Server je implementací Model Context Protocolu (MCP), která umožňuje velkým jazykovým modelům (LLM) a AI asistentům přímo pracovat s daty uloženými v Couchbase clusterech. Jako middleware umožňuje bezproblémovou integraci Couchbase databázových operací do vývojářských workflow poháněných AI. Podporuje úlohy jako získávání struktury kolekcí, přístup k dokumentům podle ID, vkládání nebo mazání dokumentů a provádění SQL++ dotazů. Propojením LLM s živými daty Couchbase mohou vývojáři automatizovat správu databáze, zvýšit produktivitu a zjednodušit komplexní datové operace prostřednictvím rozhraní v přirozeném jazyce. Server lze nakonfigurovat pro režim pouze pro čtení nebo pro zápis a je kompatibilní s různými MCP klienty, jako jsou Claude Desktop, Cursor a Windsurf.

Seznam promptů

V repozitáři nejsou uvedeny žádné informace o šablonách promptů.

Seznam zdrojů

V souborech repozitáře ani README nejsou explicitně definovány žádné zdroje.

Seznam nástrojů

• Získat seznam všech scope a kolekcí: Získání metadat o organizaci zvoleného Couchbase bucketu.
• Získat strukturu kolekce: Získání informací o struktuře (schéma) vybrané kolekce.
• Získat dokument podle ID: Získání dokumentu z určeného scope a kolekce podle jeho unikátního ID.
• Upsert dokumentu podle ID: Vložení nebo aktualizace dokumentu v určeném scope a kolekci.
• Smazat dokument podle ID: Odstranění dokumentu z daného scope a kolekce.
• Spustit SQL++ dotaz: Provedení dotazu SQL++ (ve výchozím nastavení pouze pro čtení, případně s povolením zápisu) nad určeným scope. Z bezpečnostních důvodů jsou dotazy měnící data standardně zakázány.

Použití tohoto MCP Serveru

• Správa databáze: Automatizace běžných databázových operací, jako je přidávání, aktualizace nebo mazání dokumentů přímo z AI rozhraní a tím snížení manuální režie.
• Průzkum dat: Umožňuje vývojářům i AI agentům rychle prozkoumávat datové struktury, kolekce a obsah dokumentů pro analytické či ladicí účely.
• Interaktivní dotazování: Umožňuje přirozené jazykové dotazy převáděné na SQL++ a spouštěné na Couchbase, takže získávání dat je dostupné i pro neodborníky.
• Automatizované reportování: Umožňuje generování dynamických reportů dotazováním a agregací dat pomocí AI workflow.
• Bezproblémová integrace do vývojových workflow: Zvyšuje produktivitu integrací přístupu k datům Couchbase do nástrojů jako Claude, Cursor či Windsurf a zjednodušuje kontextové kódování a dokumentaci.

Jak nastavit

Windsurf

1. Požadavky: Ujistěte se, že máte Python 3.10+ a uv; přístup k Couchbase clusteru.
2. Naklonujte repozitář:

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

3. Upravte konfiguraci MCP klienta Windsurf tak, aby obsahovala 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. Restartujte Windsurf, aby se změny projevily.
5. Ověřte připojení spuštěním testovacího dotazu.

Claude

1. Požadavky: Python 3.10+, uv, přístup k Couchbase clusteru, nainstalovaný Claude Desktop.
2. Naklonujte repozitář Couchbase MCP Server.
3. Najděte konfigurační soubor:
   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
4. Přidejte konfiguraci serveru, jak je uvedeno výše, do sekce mcpServers.
5. Restartujte Claude Desktop.
6. Ověřte dotazováním Couchbase dat přes rozhraní Claude.

Cursor

1. Ujistěte se, že máte Python 3.10+, uv a přístup ke Couchbase clusteru.
2. Naklonujte repozitář a případně doinstalujte závislosti.
3. Přidejte Couchbase MCP server do konfigurace 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. Restartujte Cursor.
5. Ověřte spuštěním databázové operace.

Cline

1. Splňte požadavky: Python 3.10+, uv, Couchbase cluster.
2. Naklonujte repozitář lokálně.
3. Přidejte následující do MCP konfigurace v 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 změny a restartujte Cline.
5. Ověřte nastavení provedením databázové akce.

Zabezpečení API klíčů:
Všechny citlivé hodnoty (např. CB_PASSWORD) se ukládají jako proměnné prostředí v sekci env konfiguračního souboru.
Příklad:

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

Jak použít tento MCP ve flow

Použití MCP ve FlowHunt

Pro integraci MCP serverů do svého workflow ve FlowHunt začněte přidáním MCP komponenty do svého flow a propojením s AI agentem:

Klikněte na MCP komponentu pro otevření konfiguračního panelu. V sekci systémové konfigurace MCP vložte detaily svého MCP serveru v tomto JSON formátu:

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

Po konfiguraci může AI agent tento MCP využívat jako nástroj se všemi jeho funkcemi a možnostmi. Nezapomeňte změnit “couchbase” na skutečný název vašeho MCP serveru a URL na adresu vašeho serveru.

Přehled

Na základě výše uvedené tabulky je Couchbase MCP Server dobře zdokumentován z hlediska nastavení a nástrojů, ale chybí mu explicitní šablony promptů, definice zdrojů a dokumentace o podpoře vzorkování/roots. Jeho užitečnost pro databázové úkoly je zřejmá, ale mohl by být vylepšen o více MCP-native funkcí. Tento MCP server hodnotím 6/10 pro obecné použití s LLM a vývojáři.

MCP skóre