# mcp-server-couchbase

Даёт агенту доступ к кластеру Couchbase: посмотреть схему, выполнить SQL++, прочитать и записать документы. По умолчанию только чтение.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 34
- Автор: couchbase
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/couchbase/mcp-server-couchbase
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/mcp-server-couchbase

## Что делает

Сервер ставится через `uvx` и работает с Capella или self-managed Couchbase Server. Агент получает инструменты для просмотра бакетов, скоупов и коллекций, запуска SQL++ и полнотекстовых запросов, чтения документов, диагностики производительности кластера. Это разговорный доступ к данным без переключения в консоль.

По умолчанию включён режим только чтения: инструменты записи не загружаются, изменяющие запросы блокируются, пока не выставить `CB_MCP_READ_ONLY_MODE=false`. Отдельные инструменты можно отключать или требовать подтверждения пользователя. Права всё равно решает RBAC самого пользователя Couchbase, а не настройки сервера.

Нужны Python 3.10+ и подключение к кластеру: строка соединения, логин, пароль. Для TLS пригодятся `CB_CA_CERT_PATH` и `CB_CLIENT_CERT_PATH`. Транспорт — STDIO для локальных клиентов или Streamable HTTP с OAuth 2.1, если сервер общий.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `CB_CONNECTION_STRING`, `CB_USERNAME`, `CB_PASSWORD`, `CB_CA_CERT_PATH`, `CB_CLIENT_CERT_PATH`, `CB_CLIENT_KEY_PATH`, `CB_MCP_READ_ONLY_MODE`, `CB_MCP_TRANSPORT`, `CB_MCP_HOST`, `CB_MCP_PORT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env CB_CONNECTION_STRING=<CB_CONNECTION_STRING> --env CB_USERNAME=<CB_USERNAME> --env CB_PASSWORD=<CB_PASSWORD> --env CB_CA_CERT_PATH=<CB_CA_CERT_PATH> --env CB_CLIENT_CERT_PATH=<CB_CLIENT_CERT_PATH> --transport stdio mcp-server-couchbase -- uvx couchbase-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 28 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from couchbase-mcp-server <команда>

### Codex

**Командой платформы**
```bash
codex mcp add mcp-server-couchbase --env CB_CONNECTION_STRING=<CB_CONNECTION_STRING> --env CB_USERNAME=<CB_USERNAME> --env CB_PASSWORD=<CB_PASSWORD> --env CB_CA_CERT_PATH=<CB_CA_CERT_PATH> --env CB_CLIENT_CERT_PATH=<CB_CLIENT_CERT_PATH> -- uvx couchbase-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 28 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from couchbase-mcp-server <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server-couchbase": {
            "command": "uvx",
            "args": [
                "couchbase-mcp-server"
            ],
            "env": {
                "CB_CONNECTION_STRING": "<CB_CONNECTION_STRING>",
                "CB_USERNAME": "<CB_USERNAME>",
                "CB_PASSWORD": "<CB_PASSWORD>",
                "CB_CA_CERT_PATH": "<CB_CA_CERT_PATH>",
                "CB_CLIENT_CERT_PATH": "<CB_CLIENT_CERT_PATH>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 28 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from couchbase-mcp-server <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server-couchbase": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "couchbase-mcp-server"
            ],
            "env": {
                "CB_CONNECTION_STRING": "<CB_CONNECTION_STRING>",
                "CB_USERNAME": "<CB_USERNAME>",
                "CB_PASSWORD": "<CB_PASSWORD>",
                "CB_CA_CERT_PATH": "<CB_CA_CERT_PATH>",
                "CB_CLIENT_CERT_PATH": "<CB_CLIENT_CERT_PATH>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 28 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from couchbase-mcp-server <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e CB_CONNECTION_STRING=<CB_CONNECTION_STRING> -e CB_USERNAME=<CB_USERNAME> -e CB_PASSWORD=<CB_PASSWORD> -e CB_CA_CERT_PATH=<CB_CA_CERT_PATH> -e CB_CLIENT_CERT_PATH=<CB_CLIENT_CERT_PATH> mcp-server-couchbase uvx couchbase-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 28 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from couchbase-mcp-server <команда>

## Когда брать
- посмотреть бакеты, скоупы и коллекции кластера без консоли
- прогнать SQL++ запрос по данным из чата
- прочитать или записать документ по ключу
- разобраться, почему запрос тормозит, по метрикам кластера
- найти документы полнотекстовым поиском

## Примеры запросов агенту
- Покажи бакеты, скоупы и коллекции в моём кластере Couchbase
- Выполни SQL++ запрос по коллекции `users` и покажи первые строки
- Прочитай документ с ключом `order::1042` в коллекции `orders`

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md