Same collection group
Couchbase MCP
by couchbase · couchbase/mcp-server-couchbase
Explore Capella or self-managed Couchbase clusters, inspect document schemas, and run SQL++ queries with Couchbase’s own MCP server.
Install from the author’s instructions
Before connecting
- Install uv and provide access to a Couchbase cluster.
- Set a connection string and cluster credentials in the author’s client configuration.
Claude Desktop / Cursor · username and password
{
"mcpServers": {
"couchbase": {
"command": "uvx",
"args": [
"couchbase-mcp-server"
],
"env": {
"CB_CONNECTION_STRING": "couchbases://connection-string",
"CB_USERNAME": "username",
"CB_PASSWORD": "password"
}
}
}
}Sources: Author README · Checked 2026-10-14.
Replace all connection and credential placeholders. The README documents read-only mode enabled by default and per-tool controls; cluster permissions still determine accessible data.
Sources: Author README · Checked 2026-10-14.
Tools and capabilities
| Capability | What it does |
|---|---|
| get_cluster_health_and_services | Inspect cluster health and available services. |
| get_schema_for_collection | Discover the structure of documents in a collection. |
| run_sql_plus_plus_query | Execute SQL++ queries against Couchbase data. |
| Key-value operations | Read documents and, when enabled, change them by ID. |
Sources: Author README · Checked 2026-10-14.
Workflow examples
Suggested prompts for your own client. These are examples, not recorded tool executions.
Prompt 1
Inspect the buckets, scopes and collections in my selected Couchbase cluster, then describe one collection’s schema.Prompt 2
Check cluster health and explain which SQL++ query would answer my question before running a bounded read.Sources and verification
Author README, linked first-party setup instructions and public repository metadata reviewed on 2026-10-14. No third-party package was installed, no MCP server was executed, and no hosted service was connected.
Recent activity refers to the repository push timestamp. It does not establish the product’s original release date. Stars are a dated snapshot of the entire repository.
- GitHub repository metadataVerified 2026-10-14
- Author READMEVerified 2026-10-14
- Official MCP Registry recordVerified 2026-10-14