by Couchbase
Couchbase MCP Server is a self-hosted MCP server that lets AI agents inspect and query Couchbase clusters. It works with Capella and self-managed clusters and is read-only by default.
PluginContact for pricing
Step 1: Have a running Couchbase cluster, on Capella or self-managed, and an MCP client. The README notes the Capella free tier as a quick way to get one.
Step 2: Install with uvx (needs uv and Python 3.11 or later) or run the couchbase/mcp-server Docker image.
Step 3: Add a couchbase entry to your client's mcpServers with the operational subcommand and set CB_CONNECTION_STRING, CB_USERNAME and CB_PASSWORD.
Step 4: Restart the client and ask about your buckets, schemas or slow queries.
Step 5: Set CB_MCP_READ_ONLY_MODE=false only if you want the agent to write documents or change structure.
Not by default. Write tools are not loaded and data-modifying queries are blocked until you set CB_MCP_READ_ONLY_MODE=false.
Yes. The operational server works with Couchbase Capella and self-managed Couchbase Server. Some admin tools need self-managed Couchbase Server 7.6 or later and are not registered on Capella connections.
STDIO for local desktop clients and Streamable HTTP, which can use OAuth 2.1, health checks and audit logging.
Yes, by licensing Couchbase AI Data Plane, which also covers Couchbase Agent Memory and Couchbase Agent Catalog.
Requirements