mcp-server-couchbase

Couchbase Model Context Protocol Server to interact with Couchbase clusters

stdio v0.6.1

Connection Configuration

Add this to your AI agent's MCP config file to connect.

Run in your terminal:

claude mcp add io.github.couchbase-ecosystem--mcp-server-couchbase -- uvx

Server Details

Transport

stdio

Authentication

None

Version

v0.6.1

Server Name

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

Last Updated

Feb 6, 2026

Get Started

How to install and connect this MCP server.

Required Configuration

Environment variables you must provide when running this server.

Variable	Description	Required
`CB_CONNECTION_STRING`	Couchbase connection string. Required for connecting to the cluster.	Optional
`CB_USERNAME`	Couchbase database username. Required for basic authentication.	Optional
`CB_PASSWORD` secret	Couchbase database password. Required for basic authentication.	Optional
`CB_CA_CERT_PATH`	Couchbase CA certificate path. Required for TLS authentication in non Capella clusters.	Optional
`CB_CLIENT_CERT_PATH`	Couchbase client certificate path. Required for mTLS authentication.	Optional
`CB_CLIENT_KEY_PATH`	Couchbase client key path. Required for mTLS authentication.	Optional
`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.	Optional
`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.	Optional
`CB_MCP_TRANSPORT`	Transport mode for the server (stdio, http or sse). Default is stdio	Optional
`CB_MCP_HOST`	Host to run the MCP server on (default: 127.0.0.1). Used only for HTTP and SSE transport modes.	Optional
`CB_MCP_PORT`	Port to run the MCP server on (default: 8000). Used only for HTTP and SSE transport modes.	Optional
`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.	Optional

mcp-server-couchbase

Connection Configuration

Server Details

Get Started

Python / uvx

Docker

Required Configuration