Couchbase MCP Server
Couchbase MCP Server is a self-hosted MCP Server that allows AI agents to connect to and interact with data in Couchbase clusters, whether hosted on Capella or self-managed. It provides tools across categories including Cluster Health, Data Schema, Key-Value, Query, and Performance — with safety controls via read-only mode and fine-grained tool disabling. It supports both STDIO and Streamable HTTP transports.
Couchbase MCP server is distributed as a Python Package Index (PyPI) package and via Docker. Enterprise support for Couchbase MCP Server is available by licensing Couchbase AI Data Plane, which also entitles use and enterprise support of Couchbase Agent Memory and Couchbase Agent Catalog.
Architecture
For the component breakdown and request flow, see Architecture.
Tools
The server exposes several tools across multiple categories.
See the Tools page for full details.
| Category | Tools |
|---|---|
| Cluster Setup & Health | get_server_configuration_status, test_cluster_connection, get_cluster_health_and_services |
| Data Model & Schema Discovery | get_buckets_in_cluster, get_scopes_in_bucket, get_collections_in_scope, get_scopes_and_collections_in_bucket, get_schema_for_collection |
| Document KV Operations | get_document_by_id, upsert_document_by_id, insert_document_by_id, replace_document_by_id, delete_document_by_id |
| Query and Indexing | run_sql_plus_plus_query, explain_sql_plus_plus_query, list_indexes, get_index_advisor_recommendations |
| Query Performance Analysis | get_longest_running_queries, get_most_frequent_queries, get_queries_not_selective, get_queries_not_using_covering_index, get_queries_using_primary_index, get_queries_with_largest_response_sizes, get_queries_with_large_result_count |
Releases
The latest release is available on PyPI and Docker Hub.
See the Release Notes for version history and details.
Support Policy
Enterprise support for Couchbase MCP Server is available by licensing Couchbase AI Data Plane, which also entitles use and enterprise support of Couchbase Agent Memory and Couchbase Agent Catalog.