Model Context Protocol moderate risk

Couchbase

The Couchbase MCP Server enables LLMs to interact with Couchbase clusters, offering tools for cluster management, schema discovery, data operations, query execution, and performance analysis, with configurable read-only modes for safety.

Connections & Capabilities

Connects To

GitHubDocker

Capabilities

readwriteexecadmin

Quickstart

Install

uvx couchbase-mcp-server --version

Config

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": ["couchbase-mcp-server"],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_USERNAME": "username",
        "CB_PASSWORD": "password"
      }
    }
  }
}

Exposed MCP Tools (23)

safe

get_server_configuration_status

Retrieves the status of the MCP server.

Read-only operation with no side effects.

safe

test_cluster_connection

Tests the connection to the Couchbase cluster using provided credentials.

Read-only operation that only validates connectivity.

safe

get_cluster_health_and_services

Retrieves the health status and list of running services in the Couchbase cluster.

Read-only operation providing cluster information.

safe

get_buckets_in_cluster

Lists all buckets within the Couchbase cluster.

Read-only operation listing available buckets.

safe

get_scopes_in_bucket

Lists all scopes within a specified bucket.

Read-only operation listing scopes in a bucket.

safe

get_collections_in_scope

Lists all collections within a specified scope and bucket.

Read-only operation listing collections.

safe

get_scopes_and_collections_in_bucket

Lists all scopes and collections within a specified bucket.

Read-only operation listing scopes and collections.

safe

get_schema_for_collection

Retrieves the schema structure for a specified collection.

Read-only operation retrieving schema information.

safe

get_document_by_id

Retrieves a document by its ID from a specified scope and collection.

Read-only operation retrieving a single document.

high

upsert_document_by_id

Upserts (inserts or updates) a document by ID to a specified scope and collection.

Modifies data by inserting or updating a document; disabled by default in read-only mode.

high

insert_document_by_id

Inserts a new document by ID into a specified scope and collection (fails if the document already exists).

Modifies data by inserting a new document; disabled by default in read-only mode.

high

replace_document_by_id

Replaces an existing document by ID in a specified scope and collection (fails if the document does not exist).

Modifies data by replacing an existing document; disabled by default in read-only mode.

critical

delete_document_by_id

Deletes a document by ID from a specified scope and collection.

Destructive operation that permanently removes a document; disabled by default in read-only mode.

safe

list_indexes

Lists all indexes in the cluster with their definitions, optionally filtered by bucket, scope, collection, and index name.

Read-only operation listing index information.

safe

get_index_advisor_recommendations

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

Read-only operation providing index optimization suggestions.

moderate

run_sql_plus_plus_query

Executes a SQL++ query on a specified scope.

Can potentially modify data depending on the query; write operations are blocked in read-only mode.

safe

get_longest_running_queries

Retrieves the longest running queries by average service time.