Mcp Server Couchbase
by Couchbase-Ecosystemcommunityv0.7.1
31
31
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
Install & configure
Prerequisites
- requiredPython 3.10+Python runtime
- requiredRunning Couchbase clusterA Couchbase cluster (Capella or self-hosted)https://docs.couchbase.com/cloud/get-started/create-account.html
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
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.Note: mTLS alternative uses CB_CLIENT_CERT_PATH and CB_CLIENT_KEY_PATH instead of username/password.
Tools (24)
get_server_configuration_status
Get the status of the MCP server
test_cluster_connection
Check the cluster credentials by connecting to the cluster
get_cluster_health_and_services
Get cluster health status and list of all running services
get_buckets_in_cluster
Get a list of all the buckets in the cluster
get_scopes_in_bucket
Get a list of all the scopes in the specified bucket
get_collections_in_scope
Get a list of all the collections in a specified scope and bucket
get_scopes_and_collections_in_bucket
Get a list of all the scopes and collections in the specified bucket
get_schema_for_collection
Get the structure for a collection
get_document_by_id
Get a document by ID from a specified scope and collection
upsert_document_by_id
Upsert a document by ID to a specified scope and collection
insert_document_by_id
Insert a new document by ID (fails if document exists)
replace_document_by_id
Replace an existing document by ID (fails if document doesn't exist)
Environment variables
CB_CONNECTION_STRINGrequiredConnection string to the Couchbase clusterCB_USERNAMErequiredUsername with access to required buckets for basic authenticationCB_PASSWORDrequiredPassword for basic authenticationPrerequisites
- • Python 3.10+
- • Python 3.10
Packages
couchbase-mcp-server
pypiv0.7.1transport: stdio
docker.io/couchbaseecosystem/mcp-server-couchbase:0.7.1
ocitransport: stdio
Details
- Language
- Python
- License
- Apache-2.0
- Released
- Apr 9, 2026
- Last commit
- Apr 10, 2026
- Registry name
- io.github.Couchbase-Ecosystem/mcp-server-couchbase