What are the prerequisites to run the server?
Python 3.10+, a running Couchbase cluster (Capella free tier works), `uv` installed, and an MCP client like Claude Desktop.
Couchbase MCP Server
@Couchbase-Ecosystem
Basic information
About Couchbase MCP Server
MCP Server to interact with data in Couchbase Clusters
Couchbase MCP Server config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"couchbase": {
"command": "uvx",
"args": [
"couchbase-mcp-server"
],
"env": {
"CB_CONNECTION_STRING": "couchbases://connection-string",
"CB_USERNAME": "username",
"CB_PASSWORD": "password",
"CB_BUCKET_NAME": "bucket_name"
}
}
}
}Couchbase MCP Server tools
Tool list not available yet
This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.
Fetch the live tool list by running this server in a temporary sandbox using the button above.
Overview
What is 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.
How to use Couchbase MCP Server?
Install the server via PyPI (uvx couchbase-mcp-server) or Docker, or run from source. Configure it in an MCP client (e.g., Claude Desktop) by providing connection details (connection string, credentials or mTLS certificates) in the client’s mcpServers JSON. The server supports both STDIO and Streamable HTTP transports.
Key features of Couchbase MCP Server
- Self-hosted; connects to Capella or self-managed Couchbase clusters
- Tools: cluster health, schema discovery, KV operations, SQL++ queries
- Performance analysis tools for query optimization
- Read-only mode and per-tool disabling for safety control
- Supports basic authentication and mTLS for secure connections
- Distributed as PyPI package and Docker image
Use cases of Couchbase MCP Server
- AI agents querying and managing documents in Couchbase buckets
- Automated schema discovery for analytics or data cataloging
- Performance monitoring and query optimization via SQL++ tools
- Integrating Couchbase data into MCP-enabled LLM workflows
Frequently asked questions
How do I authenticate the server to a Couchbase cluster?
Either provide username/password (`CB_USERNAME`, `CB_PASSWORD`) or use mTLS client certificate and key (`CB_CLIENT_CERT_PATH`, `CB_CLIENT_KEY_PATH`). The connection string is always required.
What is read-only mode?
When the environment variable `CB_MCP_READ_ONLY_MODE` is set to `true`, all KV write tools are disabled and SQL++ queries that modify data are blocked. This is the default setting.
Can I disable specific tools?
Yes, you can fine‑tune which tools are available by disabling individual tools through server configuration.
How is the server distributed and supported?
It is available as a PyPI package and via Docker. Enterprise support is available through licensing Couchbase AI Data Plane.
More Other MCP servers
MCP Toolbox for Databases
googleapisMCP Toolbox for Databases is an open source MCP server for databases.
15.9K
ICSS
chokcoco不止于 CSS
20.7K
Sequential Thinking
modelcontextprotocolModel Context Protocol Servers
88.2K
N
Next Generation Movers: free moving quotes (remote MCP)
Next Generation MoversFree moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40
Lemon.io
lemon-ioRequest dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3
Comments