# Couchbase

A self-hosted MCP server that links AI agents to data in Couchbase clusters, on Capella or self-managed. The agent inspects the cluster, queries it and works with documents in plain language.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: couchbase-ecosystem
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/couchbase-ecosystem/mcp-server-couchbase
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/couchbase

## What it does

The server connects clients such as Claude Code, Cursor or Copilot to a Couchbase Server or Capella cluster. Through it an agent lists buckets, scopes and collections, explores schemas, issues SQL++ statements, runs full-text and vector search, reads and writes documents, and checks slow queries and cluster health.

It ships read-only: write tools stay unloaded and data-changing statements are blocked until `CB_MCP_READ_ONLY_MODE=false` is set. Single tools can be turned off or placed behind user confirmation. Two transports are available: STDIO for local clients and Streamable HTTP with OAuth 2.1 for shared setups.

Distribution goes through PyPI as `couchbase-mcp-server` and a `couchbase/mcp-server` image on Docker Hub; Python 3.11 or newer is required. The Couchbase account's RBAC roles stay the real security boundary, so even with writes enabled the agent cannot exceed its permissions.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- list buckets, scopes and collections through an agent
- turn a plain-language question into a SQL++ query
- run full-text or vector search over Couchbase documents
- read and update documents from the chat
- troubleshoot slow queries and cluster issues

## Example prompts
- Show which buckets and collections this cluster has
- Find documents from the last week in `orders` with SQL++
- Run a vector search over the `products` collection and show the closest entries

## Similar
- [mcp-server-couchbase](https://affpapa.org/en/nevibecode/mcp/mcp-server-couchbase.md) — MCP server · ★ 34 repo stars
- [design-database-schema](https://affpapa.org/en/nevibecode/commands/design-database-schema.md) — command · 1021 installs
- [database-architect](https://affpapa.org/en/nevibecode/skills/database-architect.md) — skill · 586 installs
- [database-management-patterns](https://affpapa.org/en/nevibecode/skills/database-management-patterns.md) — skill · 467 installs
- [database-patterns](https://affpapa.org/en/nevibecode/skills/orchestkit-database-patterns.md) — skill · 238 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
