Couchbase — MCP-сервер для Claude Code: что делает и как установить
Самостоятельно развёртываемый MCP-сервер, который подключает ИИ-агентов к данным в кластерах Couchbase: на Capella или в собственной инфраструктуре. Агент осматривает кластер, запускает запросы и читает документы на естественном языке.
лицензия не указана обновлён 2026-10-29
Открыть на GitHubЧто делает Couchbase
Сервер связывает клиентов вроде Claude Code, Cursor или Copilot с кластером Couchbase Server либо Capella. Агент через него изучает бакеты, скоупы и коллекции, смотрит схемы, выполняет запросы SQL++, полнотекстовый и векторный поиск, читает и записывает документы и разбирает медленные запросы.
По умолчанию сервер работает только на чтение: инструменты записи не загружаются, а изменяющие запросы блокируются, пока не выставить CB_MCP_READ_ONLY_MODE=false. Отдельные инструменты можно отключать или прятать за подтверждением пользователя. Транспорты два: STDIO для локальных клиентов и Streamable HTTP с OAuth 2.1 для общих развёртываний.
Распространяется через PyPI как couchbase-mcp-server и как образ couchbase/mcp-server на Docker Hub; нужен Python 3.11 и старше. Права пользователя Couchbase по RBAC остаются главной границей доступа — даже с включённой записью агент не выйдет за роль учётной записи.
Какие задачи решает
- посмотреть бакеты, скоупы и коллекции кластера через агента
- запустить запрос SQL++ на естественном языке
- сделать полнотекстовый или векторный поиск по документам
- прочитать и изменить документы в Couchbase из чата
- найти причину медленных запросов и проблем кластера
Примеры запросов агенту
- Покажи, какие бакеты и коллекции есть в кластере
- Найди в
ordersдокументы за последнюю неделю через SQL++ - Запусти векторный поиск по коллекции
productsи выведи ближайшие записи
Как установить Couchbase
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Couchbase
Как установить Couchbase MCP-сервер?
Сервер ставится из PyPI как пакет couchbase-mcp-server или запускается как образ couchbase/mcp-server из Docker Hub. После установки его прописывают в настройках MCP-клиента, указав параметры подключения к кластеру.
Что делает Couchbase MCP-сервер?
Даёт ИИ-агенту доступ к данным Couchbase: осмотр кластера и схем, запросы SQL++, полнотекстовый и векторный поиск, чтение и запись документов, диагностику запросов и кластера.
Может ли агент изменять данные через этот сервер?
По умолчанию нет: режим только для чтения отключён записью CB_MCP_READ_ONLY_MODE=false. Даже с ней границей доступа остаются роли RBAC учётной записи Couchbase.