Couchbase MCP Server

An MCP server implementation that integrates Couchbase as a data source to Claude and other MCP Clients

Features

• Get a list of all the scopes and collections in the specified bucket in a Couchbase cluster
• Get the structure for a collection in a Couchbase cluster
• Run a SQL++ query in a Couchbase cluster

Prerequisites

• Python 3.10 or higher.
• A running Couchbase cluster. The easiest way to get started is to use the Couchbase Cloud free tier.
• uv installed to run the server.
• Claude Desktop installed to connect the server to Claude.

Configuration

1. Clone the repository to your local machine.

   git clone https://github.com/Couchbase-Ecosystem/mcp-server-couchbase.git
   

2. The MCP server can now be added to Claude Desktop by editing the configuration file. More detailed instructions can be found on the MCP quickstart guide.

   • On Mac, the configuration file is located at ~/Library/Application Support/Claude/claude_desktop_config.json
   • On Windows, the configuration file is located at %APPDATA%\Claude\claude_desktop_config.json

   Open the configuration file and add the following to the mcpServers:

   "couchbase": {
               "command": "uv",
               "args": [
                   "--directory",
                   "/path/to/couchbase-mcp-server-repo/",
                   "run",
                   "src/mcp_server.py"
               ],
               "env": {
                   "CB_CONNECTION_STRING": "couchbases://connection-string",
                   "CB_USERNAME": "username",
                   "CB_PASSWORD": "password",
                   "CB_BUCKET_NAME": "bucket_name"
               }
           }
   

   The server can be configured using environment variables. The following variables are supported:

   • CB_CONNECTION_STRING: The connection string to the Couchbase cluster
   • CB_USERNAME: The username with access to the bucket to use to connect
   • CB_PASSWORD: The password for the username to connect
   • CB_BUCKET_NAME: The name of the bucket that the server will access

3. Restart Claude Desktop to apply the changes.

4. You can now use the server in Claude Desktop to run queries on the Couchbase cluster using natural language.