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

Command

Environment

• CB_CONNECTION_STRING

  Couchbase connection string. Required for connecting to the cluster.

• CB_USERNAME

  Couchbase database username. Required for basic authentication.

• CB_PASSWORDsecret

  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.