mcp-server-couchbase — MCP-сервер для Claude Code: подключение
Даёт агенту доступ к кластеру Couchbase: посмотреть схему, выполнить SQL++, прочитать и записать документы. По умолчанию только чтение.
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Что делает 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, если сервер общий.
Какие задачи решает
- посмотреть бакеты, скоупы и коллекции кластера без консоли
- прогнать SQL++ запрос по данным из чата
- прочитать или записать документ по ключу
- разобраться, почему запрос тормозит, по метрикам кластера
- найти документы полнотекстовым поиском
Примеры запросов агенту
- Покажи бакеты, скоупы и коллекции в моём кластере Couchbase
- Выполни SQL++ запрос по коллекции
usersи покажи первые строки - Прочитай документ с ключом
order::1042в коллекцииorders
Как установить mcp-server-couchbase
Командой платформы
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 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 <команда>
Файл настроек
{
"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 <команда>
Файл настроек
{
"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 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 <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-server-couchbase
Как установить mcp-server-couchbase в Claude Code?
Выполните claude mcp add mcp-server-couchbase -e CB_PASSWORD=<CB_PASSWORD> -- uvx couchbase-mcp-server. Если нужны сертификаты и строка соединения, есть второй вариант с флагами --env CB_CONNECTION_STRING, CB_USERNAME, CB_PASSWORD, CB_CA_CERT_PATH, CB_CLIENT_CERT_PATH и --transport stdio.
Что делает mcp-server-couchbase?
Соединяет ИИ-агента с кластером Couchbase Server или Capella: агент смотрит схему, выполняет SQL++ и полнотекстовые запросы, читает документы и диагностирует производительность.
Может ли агент изменить данные?
По умолчанию нет: сервер работает в режиме только чтения и блокирует изменяющие запросы. Запись включается установкой CB_MCP_READ_ONLY_MODE=false, а границы доступа задаёт RBAC пользователя Couchbase.
