# MCP Couchbase

> A Python MCP (Model Context Protocol) server exposing the full Couchbase data-plane and admin REST API as tools for AI assistants like Claude.

- **Type:** MCP server
- **Install:** `agentstack add mcp-celticht32-mcp-couchbase`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [celticht32](https://agentstack.voostack.com/s/celticht32)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [celticht32](https://github.com/celticht32)
- **Source:** https://github.com/celticht32/MCP-Couchbase

## Install

```sh
agentstack add mcp-celticht32-mcp-couchbase
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Couchbase MCP Server

Full Couchbase data-plane **and** cluster-admin REST API exposed as MCP tools.
An independent, ground-up Python server (not a fork of the official
`Couchbase-Ecosystem/mcp-server-couchbase`) that reaches CRUD/data-plane parity
with the official server and adds a complete administrative surface.

- **167 tools** across 17 categories
- **Default-safe**: `CB_MCP_READ_ONLY_MODE=true` by default — writes are blocked
  until you opt in
- **Per-tool OAuth scope enforcement** on the HTTP transport
- **Confirmation gate** on destructive operations
- Two bundled web GUIs (standard + Capella), each with optional OIDC login
- 274 tests

License: MIT — Copyright (c) 2026 Chris Ahrendt
GitHub: https://github.com/celticht32/MCP-Couchbase

---

## Requirements

- Python `>=3.10, Note: the HTTP transport binds to `CB_MCP_HOST` (default `127.0.0.1`). When
> `CB_MCP_HTTP_REQUIRE_AUTH` is false there is no request authentication; deploy
> behind a reverse proxy or trusted network, or set it true.

## Tool categories

| Category      | Module                  | Tools |
|---------------|-------------------------|-------|
| Cluster ops   | `handlers/cluster`      | 29    |
| Security      | `handlers/security`     | 17    |
| Capella v4    | `handlers/capella`      | 16    |
| KV / data     | `handlers/data`         | 11    |
| Buckets       | `handlers/buckets`      | 10    |
| XDCR          | `handlers/xdcr`         | 10    |
| Diagnostics   | `handlers/diagnostics`  | 10    |
| Stats         | `handlers/stats`        | 10    |
| Eventing      | `handlers/eventing`     | 10    |
| FTS admin     | `handlers/search_admin` | 9     |
| 8.x features  | `handlers/eight_x`      | 7     |
| Extended      | `handlers/extended`     | 7     |
| Indexes       | `handlers/indexes`      | 6     |
| Collections   | `handlers/collections`  | 5     |
| Encryption    | `handlers/encryption`   | 4     |
| Synonyms      | `handlers/synonyms`     | 3     |
| MCP status    | `handlers/mcp_status`   | 3     |
| **Total**     |                         | **167** |

## Development

```powershell
py -3.13 -m pip install -e ".[dev]"
py -3.13 -m pytest
```

Pinned dev tooling (see `pyproject.toml`): `ruff==0.12.5`, `pytest==9.0.3`,
`pytest-asyncio==1.3.0`, `pre-commit==4.2.0`.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [celticht32](https://github.com/celticht32)
- **Source:** [celticht32/MCP-Couchbase](https://github.com/celticht32/MCP-Couchbase)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-celticht32-mcp-couchbase
- Seller: https://agentstack.voostack.com/s/celticht32
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.