Couchbase MCP Server

Example Use Cases

• 1

  Query Couchbase data using natural language and run SQL++ queries against a specified scope (with optional read-only enforcement).

• 2

  Retrieve, upsert, and delete individual documents by ID across buckets, scopes, and collections.

• 3

  Secure programmatic access to Couchbase clusters (basic auth or mTLS) and flexible deployment via stdio, HTTP (streamable), or Docker.

Description

This project implements a Model Context Protocol (MCP) server for Couchbase, enabling natural-language agents to list buckets, scopes, and collections, fetch and upsert documents by ID, delete documents, and run SQL++ queries (read-only by default). It supports secure connections via basic auth or mTLS, multiple transport modes (stdio, streamable HTTP, SSE), and can be run from source, PyPI, or Docker. The server includes safeguards (configurable read-only query mode) and is intended to integrate with MCP clients like Claude Desktop, Cursor, and Windsurf Editor to give agents direct access to Couchbase data.

Capabilities(19 total)