io.github.Couchbase-Ecosystem

mcp-server-couchbase

Couchbase Model Context Protocol Server to interact with Couchbase clusters

stdioofficialapplication

Package Details

couchbase-mcp-server

0.6.1•https://pypi.org/project/couchbase-mcp-server
Transportstdio

Package Arguments

Named
--connection-string
Couchbase connection string. Required for connecting to the cluster.
--username
Couchbase database username. Required for basic authentication.
--password
Couchbase database password. Required for basic authentication.
--ca-cert-path
Couchbase CA certificate path. Required for TLS authentication in non Capella clusters.
--client-cert-path
Couchbase client certificate path. Required for mTLS authentication.
--client-key-path
Couchbase client key path. Required for mTLS authentication.
--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.
--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 --read-only-mode instead.
--transport
Transport mode for the server (stdio, http or sse). Default is stdio
--host
Host to run the MCP server on (default: 127.0.0.1). Used only for HTTP and SSE transport modes.
--port
Port to run the MCP server on (default: 8000). Used only for HTTP and SSE transport modes.
--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.

Environment Variables

CB_CONNECTION_STRING(str)

Couchbase connection string. Required for connecting to the cluster.

CB_USERNAME(str)

Couchbase database username. Required for basic authentication.

CB_PASSWORD(str)
Secret

Couchbase database password. Required for basic authentication.

CB_CA_CERT_PATH(str)

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

CB_CLIENT_CERT_PATH(str)

Couchbase client certificate path. Required for mTLS authentication.

CB_CLIENT_KEY_PATH(str)

Couchbase client key path. Required for mTLS authentication.

CB_MCP_READ_ONLY_MODE(bool)

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(bool)

[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(str)

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

CB_MCP_HOST(str)

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

CB_MCP_PORT(num)

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

CB_MCP_DISABLED_TOOLS(str)

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

docker.io/couchbaseecosystem/mcp-server-couchbase:0.6.1

https://hub.docker.com/r/couchbaseecosystem/mcp-server-couchbase
Transportstdio

Environment Variables

CB_CONNECTION_STRING(str)

Couchbase connection string. Required for connecting to the cluster.

CB_USERNAME(str)

Couchbase database username. Required for basic authentication.

CB_PASSWORD(str)
Secret

Couchbase database password. Required for basic authentication.

CB_CA_CERT_PATH(str)

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

CB_CLIENT_CERT_PATH(str)

Couchbase client certificate path. Required for mTLS authentication.

CB_CLIENT_KEY_PATH(str)

Couchbase client key path. Required for mTLS authentication.

CB_MCP_READ_ONLY_MODE(bool)

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(bool)

[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(str)

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

CB_MCP_HOST(str)

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

CB_MCP_PORT(num)

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

CB_MCP_DISABLED_TOOLS(str)

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