MCP Server Couchbase logo

MCP Server Couchbase

Unclaimed

by couchbase

Model Context Protocol server for Couchbase - connect AI agents and LLMs like Claude, Cursor, and Copilot to Couchbase/Capella

Set up this server

Compare serversMy Stack

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructions

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'mcp-server-couchbase' -- 'uvx' 'couchbase-mcp-server' '--disabled-tools' 'upsert_document_by_id,' 'delete_document_by_id'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

ai-agentscapellaclaudecouchbasecursordatabasehacktoberfestllmmcpmodel-context-protocolnosqlpython

More in Databases

Browse the full directory

Unclaimed listing

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

33 of 33 tools

Documented tools (33)

From project documentation. A server handshake does not verify each tool’s description or behavior.

build_index

Trigger the build of all deferred indexes on a collection. Disabled by default when CBMCPREADONLYMODE=true.

create_collection

Create a new collection in an existing scope (Couchbase Server 7.6+ and Capella). Disabled by default when CBMCPREADONLYMODE=true.

create_index

Create a scalar (non-vector) GSI secondary index on a collection. Deferred by default — call buildindex afterward to build it. Disabled by default when CBMCPREADONLYMODE=true.

create_scope

Create a new scope in a bucket (Couchbase Server 7.6+ and Capella). Disabled by default when CBMCPREADONLYMODE=true.

delete_collection

Delete a collection and all its documents from a scope — permanent. Disabled by default when CBMCPREADONLYMODE=true.

delete_document_by_id

Delete a document by ID from a specified scope and collection. Disabled by default when CBMCPREADONLYMODE=true.

delete_scope

Delete a scope and all its collections from a bucket — permanent. Disabled by default when CBMCPREADONLYMODE=true.

drop_index

Drop a GSI index (scalar or vector) from a collection. Disabled by default when CBMCPREADONLYMODE=true.

explain_sql_plus_plus_query

Generate and evaluate an EXPLAIN plan for a SQL++ query. Returns query metadata, extracted plan, and plan evaluation findings.

get_buckets_in_cluster

Get a list of all the buckets in the cluster

get_cluster_health_and_services

Get cluster health status and list of all running services

get_collections_in_scope

Get a list of all the collections in a specified scope and bucket. Note that this tool requires the cluster to have Query service.

get_document_by_id

Get a document by ID from a specified scope and collection

get_index_advisor_recommendations

Get index recommendations from Couchbase Index Advisor for a given SQL++ query to optimize query performance

get_longest_running_queries

Get longest running queries by average service time

get_most_frequent_queries

Get most frequently executed queries

get_queries_not_selective

Get queries that are not selective (index scans return many more documents than final result)

get_queries_not_using_covering_index

Get queries that don't use a covering index

get_queries_using_primary_index

Get queries that use a primary index (potential performance concern)

get_queries_with_large_result_count

Get queries with the largest result counts

get_queries_with_largest_response_sizes

Get queries with the largest response sizes

get_schema_for_collection

Get the structure for a collection

get_scopes_and_collections_in_bucket

Get a list of all the scopes and collections in the specified bucket

get_scopes_in_bucket

Get a list of all the scopes in the specified bucket

get_server_configuration_status

Get the server status and configuration without connecting to the cluster — reports read-only mode, disabled/confirmation-required tools, OAuth settings, and the resolved logging configuration

insert_document_by_id

Insert a new document by ID (fails if document exists). Disabled by default when CBMCPREADONLYMODE=true.

list_indexes

List all indexes in the cluster with their definitions, with optional filtering by bucket, scope, collection and index name. Set returnrawindexstats=true to return the unprocessed index information.

lookup_subdocument

Look up parts of a document (specific fields, existence checks, or array/object counts) by path without fetching the whole document

mutate_subdocument

Modify parts of an existing document (upsert, insert, replace, remove, array ops, counters) by path without rewriting the whole document. Disabled by default when CBMCPREADONLYMODE=true.

replace_document_by_id

Replace an existing document by ID (fails if document doesn't exist). Disabled by default when CBMCPREADONLYMODE=true.

run_sql_plus_plus_query

Run a SQL++ query on a specified scope.<br><br>Queries are automatically scoped to the specified bucket and scope, so use collection names directly (e.g., SELECT FROM users instead of SELECT FROM bucket.scope.users).<br><br>CBMCPREADONLYMODE is true by default, which means that all write operations

test_cluster_connection

Check the cluster credentials by connecting to the cluster

upsert_document_by_id

Upsert a document by ID to a specified scope and collection. Disabled by default when CBMCPREADONLYMODE=true.

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about MCP Server Couchbase MCP Server

How do I connect MCP Server Couchbase MCP Server to Claude?
Run `claude mcp add mcp-server-couchbase -- uvx couchbase-mcp-server --disabled-tools upsert_document_by_id, delete_document_by_id` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is MCP Server Couchbase MCP Server free?
The listed licence is Apache-2.0. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can MCP Server Couchbase MCP Server do?
MCP Server Couchbase MCP Server documents 33 tools to the agent, including build_index, create_collection, create_index. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.