An MCP server for Couchbase that lets MCP clients connect to Couchbase clusters, inspect cluster/schema information, run SQL++ queries, and perform document operations. It also includes query analysis tools for identifying performance issues and index usage.
From the registry: Couchbase Model Context Protocol Server to interact with Couchbase clusters
Please install the `mcp-server-couchbase` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Python 3.10+** — Python runtime
- **Running Couchbase cluster** — A Couchbase cluster (Capella or self-hosted) (https://docs.couchbase.com/cloud/get-started/create-account.html)
Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["couchbase-mcp-server"]
- required environment variables:
- `CB_CONNECTION_STRING`: Couchbase connection string (example: `couchbases://<your-connection-string>`)
- `CB_USERNAME`: Couchbase username (example: `<your-username>`)
- `CB_PASSWORD`: Couchbase password (example: `<your-password>`)
- optional environment variables:
- `CB_MCP_READ_ONLY_MODE`: Read-only mode (default true) (example: `true`)
Note: mTLS alternative uses CB_CLIENT_CERT_PATH and CB_CLIENT_KEY_PATH instead of username/password.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.CB_CONNECTION_STRINGrequiredConnection string to the Couchbase clusterCB_USERNAMErequiredUsername with access to required buckets for basic authenticationCB_PASSWORDrequiredPassword for basic authenticationMinimal, token-efficient Database MCP Server for PostgreSQL, MySQL, SQL Server, SQLite, MariaDB