Couchbase MCP Server

Установка

Работает в

• Claude Desktop
• Cursor
• Windsurf
• VS Code
• Claude Code
• SourceCraft
• Koda
• Coddy

Ручная установка

{"mcpServers":{"couchbase":{"command":"uvx","args":["couchbase-mcp-server","operational"],"env":{"CB_CONNECTION_STRING":"couchbases://connection-string","CB_USERNAME":"username","CB_PASSWORD":"password"}}}}

Что делает

Couchbase — документная база данных, которая работает в облаке Capella или на своем кластере. Сервер подключает к ней агента и поставляется как пакет PyPI и образ Docker с двумя режимами запуска. Операционный сервер (`operational`) открывает кластер: 52 инструмента для проверки здоровья, схемы, работы с документами по ключу, запросов SQL++, индексов, полнотекстового и векторного поиска и разбора производительности запросов. Сервер Operational Insights (`operational-insights`) рассчитан на кластеры с продуктом Operational Insights, которого нет в Capella: у него 13 инструментов для схемы, синхронных и асинхронных запросов SQL++, индексов и экспорта. По умолчанию сервер только читает: инструменты записи не загружаются, и запросы, меняющие данные, блокируются, пока вы не зададите CB_MCP_READ_ONLY_MODE=false. Отдельные инструменты отключают переменной CB_MCP_DISABLED_TOOLS или ставят за подтверждение пользователя. Транспорт stdio подходит для настольных клиентов, а Streamable HTTP работает с OAuth 2.1, проверками состояния и журналом аудита для общих развертываний.

Для кого. Разработчикам и администраторам баз Couchbase, которые разбирают схемы и медленные запросы через Claude Desktop, Cursor, Windsurf, VS Code или JetBrains.

Пример запроса к агенту

Какие бакеты и коллекции есть в кластере, какая схема у orders и какие пять запросов были самыми медленными за последний час?

MCP

Транспорт

stdio, http

Авторизация

ключ необязателен

Ограничения

Нужны кластер Couchbase (подойдет бесплатный уровень Capella) и учетные данные: логин с паролем или клиентский сертификат mTLS. Запуск из PyPI требует uv и Python 3.11 или новее, запуск в Docker только Docker. Сервер Operational Insights принимает адрес HTTP(S) кластера Operational Insights, строка подключения couchbase:// ему не подходит.

Отключение инструментов записи не мешает `run_sql_plus_plus_query` выполнять INSERT, UPDATE, DELETE и MERGE, если пользователь базы имеет такие права: окончательный барьер задает RBAC. Продукт отправляет данные об использовании в Couchbase, а раздел об ограничениях LLM предупреждает о возможных неточных ответах модели.

Как отключить. Удалите блок couchbase из конфигурации клиента. Пользователя базы, созданного для агента, отключите или удалите в Couchbase, а пароль смените.

Коротко о README

В README разобраны выбор между двумя серверами, быстрый запуск через uvx и Docker, варианты входа с паролем и mTLS, таблицы инструментов, поставщики эмбеддингов, контроль безопасности, транспорты, OAuth 2.1, журналирование и аудит, настройка клиентов и разбор неполадок.