A feature-complete, officially maintained database MCP server from Couchbase: cluster health, schema discovery, KV operations, SQL++ querying, index management, and performance analysis, with safe defaults (read-only), tool disabling, execution confirmation, OAuth 2.1, and thorough logging. Ideal for Couchbase users adding AI-driven data operations in mainstream MCP clients, but remember RBAC remains the authoritative security boundary.
Strongest · Documentation 18/20 Weakest · Reliability 11/20
Static review · not runListed 2026-09-07
Read the FMRS scoring method →Runtime：Python 3.10+ · Docker
CB_CONNECTION_STRING
Couchbase cluster connection string (e.g., couchbases://...), from the Capella console or your self-managed cluster.
CB_PASSWORD
Database password for basic authentication; secret.
CB_USERNAME
Database username for basic authentication, created in Capella or Couchbase Server RBAC.
CB_CA_CERT_PATH
Server CA certificate path for TLS with self-signed/untrusted certificates; not needed for Capella.
CB_CLIENT_CERT_PATH
Client certificate file path for mTLS authentication.
CB_CLIENT_KEY_PATH
Client private key file path for mTLS authentication.
CB_MCP_READ_ONLY_MODE
Read-only switch, true by default; disables all write operations (KV, query, scope/collection and index management).
CB_MCP_TRANSPORT
Transport mode: stdio, http, or sse. Default stdio.
CB_MCP_HOST
Host the server binds to in HTTP/SSE modes, default 127.0.0.1.
CB_MCP_PORT
Port for HTTP/SSE modes, default 8000.
CB_MCP_DISABLED_TOOLS
Tools to disable: comma-separated names or a file path with one tool name per line.
CB_MCP_CONFIRMATION_REQUIRED_TOOLS
Tools requiring explicit user confirmation via MCP elicitation before execution.
CB_MCP_LOG_LEVEL
Log level: off, debug, info, warning, error. Default info.
CB_MCP_LOG_SINKS
Log destinations: stderr, file, or both. Default stderr.
CB_MCP_LOG_FILE
Base path for per-level log files, default mcp_server.log.
CB_MCP_LOG_ROTATION_MAX_SIZE_MB
Global per-level log rotation size in MB, default 1.
CB_MCP_LOG_MAX_BYTES
Deprecated byte-based rotation size; ignored when CB_MCP_LOG_ROTATION_MAX_SIZE_MB is set.
CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB
Overrides the global rotation size (MB) for the ERROR log file.
CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB
Overrides the global rotation size (MB) for the WARNING log file.
CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB
Overrides the global rotation size (MB) for the INFO log file.
CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB
Overrides the global rotation size (MB) for the DEBUG log file.
CB_MCP_LOG_RETENTION_BACKUP_COUNT
Number of rotated backups kept per level, default 1.
CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT
Overrides the global backup count for the ERROR log file.
CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT
Overrides the global backup count for the WARNING log file.
CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT
Overrides the global backup count for the INFO log file.
CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT
Overrides the global backup count for the DEBUG log file.
CB_MCP_OAUTH_JWT_JWKS_URI
Identity provider JWKS endpoint used to verify bearer JWT signatures; required for OAuth, only honored on http transport.
CB_MCP_OAUTH_JWT_ISSUER
Expected JWT 'iss' claim; required to enable OAuth.
CB_MCP_OAUTH_JWT_AUDIENCE
Expected JWT 'aud' claim; required to enable OAuth.
CB_MCP_OAUTH_JWT_ALGORITHM
JWT signing algorithm (RS256/384/512, ES256/384/512, PS256/384/512); default RS256.
CB_MCP_OAUTH_MCP_BASE_URL
Public base URL of this server; when set, publishes RFC 9728 Protected Resource Metadata.
CB_MCP_OAUTH_SCOPE_READ_LABEL
Override of the OAuth scope label treated as 'read' access; default couchbase-mcp:read.
CB_MCP_OAUTH_SCOPE_WRITE_LABEL
Override of the OAuth scope label treated as 'write' access; default couchbase-mcp:write.
Prerequisites: Python 3.10+, a running Couchbase cluster (Capella free tier is easiest), uv installed, and an MCP client such as Claude Desktop or Cursor. PyPI: add to mcpServers with command uvx and args ["couchbase-mcp-server"], setting CB_CONNECTION_STRING, CB_USERNAME, and CB_PASSWORD in env (for mTLS use CB_CLIENT_CERT_PATH and CB_CLIENT_KEY_PATH). Source: clone the repo and run uv --directory <repo-path> run src/mcp_server.py. A Docker image (docker.io/couchbase/mcp-server) is also available.
{"mcpServers":{"couchbase":{"command":"uvx","args":["couchbase-mcp-server"],"env":{"CB_CONNECTION_STRING":"couchbases://connection-string","CB_USERNAME":"username","CB_PASSWORD":"password"}}}}
Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.
{
"servers": {
"couchbase": {
"command": "uvx",
"args": [
"couchbase-mcp-server"
],
"env": {
"CB_CONNECTION_STRING": "couchbases://connection-string",
"CB_USERNAME": "username",
"CB_PASSWORD": "password"
}
}
}
}
Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).
claude mcp add couchbase -e CB_CONNECTION_STRING=couchbases://connection-string -e CB_USERNAME=username -e CB_PASSWORD=password -- uvx couchbase-mcp-server
Run it in a terminal; replace any <…> placeholders with your own values first.
Check that the couchbase server's tools (e.g., get_buckets_in_cluster) appear in the client's tool list, then ask the AI to call test_cluster_connection or list the buckets — returning real bucket names proves the connection works.
Once connected, you can ask your AI assistant things like:
No matching tools
Listed from the project's documentation, not tested by this site.
An officially maintained, self-hosted MCP Server by Couchbase that allows AI agents to connect to Couchbase clusters — whether hosted on Capella or self-managed — and interact with their data. It provides tools across Cluster Health, Data Schema, Key-Value, Query, and Performance categories, with safety controls including read-only mode by default, fine-grained tool disabling, confirmation-required tools (client elicitation), OAuth 2.1 authorization (HTTP transport), and extensive logging configuration. Distributed via PyPI (couchbase-mcp-server), Docker, or source, it supports STDIO and Streamable HTTP transports (plus deprecated SSE).
Connect ClickHouse to your AI assistants
Unofficial MCP server providing advanced access to the ChEMBL chemical database
Google's official database MCP toolbox — define AI-accessible database tools via config
Bytebase's official, minimalist two-tool database MCP server
Source revision 2a754631ab35 Data synced 2026-10-19 Read the FMRS scoring method