io.github.Couchbase-Ecosystem/mcp-server-couchbase

io.github.Couchbase-Ecosystem/mcp-server-couchbase·v0.7.1·Other

Quality Score

/100

Couchbase Model Context Protocol Server to interact with Couchbase clusters

Repository →

§01 Install

Claude Desktop (uvx)

{
  "mcpServers": {
    "mcp-server-couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "CB_CONNECTION_STRING": "<cb_connection_string>",
        "CB_USERNAME": "<cb_username>",
        "CB_PASSWORD": "<your-cb_password>",
        "CB_CA_CERT_PATH": "<cb_ca_cert_path>",
        "CB_CLIENT_CERT_PATH": "<cb_client_cert_path>",
        "CB_CLIENT_KEY_PATH": "<cb_client_key_path>",
        "CB_MCP_READ_ONLY_MODE": "<cb_mcp_read_only_mode>",
        "CB_MCP_READ_ONLY_QUERY_MODE": "<cb_mcp_read_only_query_mode>",
        "CB_MCP_TRANSPORT": "<cb_mcp_transport>",
        "CB_MCP_HOST": "<cb_mcp_host>",
        "CB_MCP_PORT": "<cb_mcp_port>",
        "CB_MCP_DISABLED_TOOLS": "<cb_mcp_disabled_tools>",
        "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "<cb_mcp_confirmation_required_tools>"
      }
    }
  }
}

Claude Desktop (Docker)

{
  "mcpServers": {
    "mcp-server-couchbase": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "docker.io/couchbaseecosystem/mcp-server-couchbase:0.7.1"
      ],
      "env": {
        "CB_CONNECTION_STRING": "<cb_connection_string>",
        "CB_USERNAME": "<cb_username>",
        "CB_PASSWORD": "<your-cb_password>",
        "CB_CA_CERT_PATH": "<cb_ca_cert_path>",
        "CB_CLIENT_CERT_PATH": "<cb_client_cert_path>",
        "CB_CLIENT_KEY_PATH": "<cb_client_key_path>",
        "CB_MCP_READ_ONLY_MODE": "<cb_mcp_read_only_mode>",
        "CB_MCP_READ_ONLY_QUERY_MODE": "<cb_mcp_read_only_query_mode>",
        "CB_MCP_TRANSPORT": "<cb_mcp_transport>",
        "CB_MCP_HOST": "<cb_mcp_host>",
        "CB_MCP_PORT": "<cb_mcp_port>",
        "CB_MCP_DISABLED_TOOLS": "<cb_mcp_disabled_tools>",
        "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "<cb_mcp_confirmation_required_tools>"
      }
    }
  }
}

§02 Environment variables

CB_CONNECTION_STRING

Couchbase connection string. Required for connecting to the cluster.

CB_USERNAME

Couchbase database username. Required for basic authentication.

CB_PASSWORD

secret

Couchbase database password. Required for basic authentication.

CB_CA_CERT_PATH

Couchbase CA certificate path. Required for TLS authentication in non Capella clusters.

CB_CLIENT_CERT_PATH

Couchbase client certificate path. Required for mTLS authentication.

CB_CLIENT_KEY_PATH

Couchbase client key path. Required for mTLS authentication.

CB_MCP_READ_ONLY_MODE

Couchbase read only mode. Set to true to allow disable write operations across both KV and query. KV write tools are not loaded and SQL++ queries that modify data are blocked. Set to false to allow data modification queries and tools.

CB_MCP_READ_ONLY_QUERY_MODE

[Deprecated] Couchbase read only query mode. Set to true to allow only read-only queries. Set to false to allow data modification queries. Use CB_MCP_READ_ONLY_MODE instead.

CB_MCP_TRANSPORT

Transport mode for the server (stdio, http or sse). Default is stdio

CB_MCP_HOST

Host to run the MCP server on (default: 127.0.0.1). Used only for HTTP and SSE transport modes.

CB_MCP_PORT

Port to run the MCP server on (default: 8000). Used only for HTTP and SSE transport modes.

CB_MCP_DISABLED_TOOLS

Tools to disable. Accepts comma-separated tool names (e.g., 'tool_1,tool_2') or a file path containing one tool name per line.

CB_MCP_CONFIRMATION_REQUIRED_TOOLS

Comma-separated tool names that require user confirmation before execution. Also accepts a file path containing one tool name per line. Requires the MCP client to support elicitation.

CB_CONNECTION_STRING

Couchbase connection string. Required for connecting to the cluster.

CB_USERNAME

Couchbase database username. Required for basic authentication.

CB_PASSWORD

secret

Couchbase database password. Required for basic authentication.

CB_CA_CERT_PATH

Couchbase CA certificate path. Required for TLS authentication in non Capella clusters.

CB_CLIENT_CERT_PATH

Couchbase client certificate path. Required for mTLS authentication.

CB_CLIENT_KEY_PATH

Couchbase client key path. Required for mTLS authentication.

CB_MCP_READ_ONLY_MODE

Couchbase read only mode. Set to true to disable write operations across both KV and query. KV write tools are not loaded and SQL++ queries that modify data are blocked. Set to false to allow data modification queries and tools.

CB_MCP_READ_ONLY_QUERY_MODE

[Deprecated] Couchbase read only query mode. Set to true to allow only read-only queries. Set to false to allow data modification queries. Use CB_MCP_READ_ONLY_MODE instead.

CB_MCP_TRANSPORT

Transport mode for the server (stdio, http or sse). Default is stdio

CB_MCP_HOST

Host to run the MCP server on (default: 127.0.0.1). Used only for HTTP and SSE transport modes.

CB_MCP_PORT

Port to run the MCP server on (default: 8000). Used only for HTTP and SSE transport modes.

CB_MCP_DISABLED_TOOLS

Tools to disable. Accepts comma-separated tool names (e.g., 'tool_1,tool_2') or a file path containing one tool name per line.

CB_MCP_CONFIRMATION_REQUIRED_TOOLS

Comma-separated tool names that require user confirmation before execution. Also accepts a file path containing one tool name per line. Requires the MCP client to support elicitation.

§03 MCP Quality Score · methodology

freshness

completeness

installability

documentation

stability

§04 Alternatives in Other

agency.lona/trading

AI-powered trading strategy development: backtesting, market data, and portfolio analysis

ABMeter

ai.abmeter/abmeter

Feature flagging and A/B testing platform with AI-first experimentation workflows.

AdAdvisor MCP Server

ai.adadvisor/mcp-server

Query Meta Ads performance data — accounts, campaigns, ad sets, ads, metrics & settings.