Couchbase

Provides an MCP endpoint that translates natural language requests into SQL++ queries against Couchbase Capella clusters.

javascript

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "hummusonrails-couchbase-mcp-server": {
      "command": "npx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "COUCHBASE_PASSWORD": "your_password",
        "COUCHBASE_USERNAME": "your_username",
        "COUCHBASE_CONNECTION_STRING": "couchbases://your-cluster.cloud.couchbase.com"
      }
    }
  }
}

You can run a Couchbase MCP Server that understands natural language requests and translates them into SQL++ queries against your Couchbase Capella clusters. This lets you ask questions like “Show the latest documents in my bucket” and get structured results without writing SQL++ yourself.

How to use

Use this MCP server with an MCP client to issue natural language queries that the server translates into SQL++ and runs against your Couchbase Capella cluster. You can ask for counts, lists, summaries, or specific fields from your buckets, and you will receive readable results back from the server.

How to install

Prepare your environment and install the MCP server locally. Follow these steps exactly to set up and run the server.

# 1. Clone the project repository
git clone git@github.com:hummusonrails/couchbase-mcp-server.git
cd couchbase-mcp-server

# 2. Install dependencies
npm install

# 3. Build the project
npm run build

# 4. Run the MCP server using the Stdio transport
npx couchbase-mcp-server

Additional notes

Environment variables you provide control how the server connects to Couchbase. Create a .env file in the project root with your connection details, or supply them directly to the environment when running the server. The required variables are shown below as placeholders you should replace with your real values.

COUCHBASE_CONNECTION_STRING=couchbases://your-cluster.cloud.couchbase.com
COUCHBASE_USERNAME=your_username
COUCHBASE_PASSWORD=your_password

Available tools

query-couchbase

Executes a SQL++ query statement against your Couchbase Capella cluster and returns the results. This tool is used to run natural language translated queries against the data source.

Built by

VeilStrat

AI signals for GTM teams