# Couchbase

Самостоятельно развёртываемый MCP-сервер, который подключает ИИ-агентов к данным в кластерах Couchbase: на Capella или в собственной инфраструктуре. Агент осматривает кластер, запускает запросы и читает документы на естественном языке.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: couchbase-ecosystem
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/couchbase-ecosystem/mcp-server-couchbase
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/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 остаются главной границей доступа — даже с включённой записью агент не выйдет за роль учётной записи.

## Требования
- Нужно: Docker

## Установка

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

**Установка**
- Команды запуска нет в реестре MCP — смотрите README репозитория

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

## Примеры запросов агенту
- Покажи, какие бакеты и коллекции есть в кластере
- Найди в `orders` документы за последнюю неделю через SQL++
- Запусти векторный поиск по коллекции `products` и выведи ближайшие записи

## Похожие
- [mcp-server-couchbase](https://affpapa.org/nevibecode/mcp/mcp-server-couchbase.md) — MCP-сервер · ★ 34 у репозитория
- [design-database-schema](https://affpapa.org/nevibecode/commands/design-database-schema.md) — команда · 1021 установка
- [database-architect](https://affpapa.org/nevibecode/skills/database-architect.md) — скилл · 586 установок
- [database-management-patterns](https://affpapa.org/nevibecode/skills/database-management-patterns.md) — скилл · 467 установок
- [database-patterns](https://affpapa.org/nevibecode/skills/orchestkit-database-patterns.md) — скилл · 238 установок

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