Couchbase-Ecosystem/mcp-server-couchbase

Генерирует и оценивает план EXPLAIN для SQL++ запроса. Он предоставляет информацию о плане выполнения запроса. Оператор EXPLAIN выполняется в указанной области в указанном bucket. Он возвращает метаданные запроса вместе с извлечённым планом и оценкой плана.

Получите имена всех доступных бакетов в кластере.

Получает состояние кластера и список всех запущенных сервисов. Инструмент отслеживает состояние через: - Получение состояния здоровья всех сервисов с информацией о задержках (через ping) - Перечисление всех сервисов, работающих на кластере, с их эндпоинтами - Отображение статуса соединения и информации об узле для каждого сервиса Если указан bucket_name, инструмент активно пингует сервисы со стороны этого bucket'а. В противном случае использует кластерный ping, чтобы получить состояние кластера. Возвращает: - Состояние кластера с деталями соединения по каждому сервису и измерениями задержек

Получить имена всех коллекций в указанной области и корзине.

Получить документ по его идентификатору из указанной области и коллекции. Если документ не найден, будет вызвано исключение.

Получает рекомендации по индексам от Couchbase Index Advisor для заданного SQL++ запроса. Index Advisor анализирует запрос и выдаёт рекомендации по оптимальным индексам. Инструмент работает с запросами SELECT, UPDATE, DELETE или MERGE. Запросы выполняются в указанном scope в указанном bucket. Возвращает словарь с: - current_used_indexes: массив используемых в данный момент индексов (если есть) - recommended_indexes: массив рекомендуемых вторичных индексов (если есть) - recommended_covering_indexes: массив рекомендуемых покрывающих индексов (если есть) Каждый объект индекса содержит: - index: команда CREATE INDEX SQL++ - statements: массив объектов инструкций с запросом и количеством запусков

Получить N самых долго выполняющихся запросов из каталога system:completed_requests.

Получить N самых частых запросов из каталога system:completed_requests.

Получить запросы, которые не очень селективны, из каталога system:completed_requests.

Получите запросы, которые не используют покрывающий индекс, из системного каталога `system:completed_requests`.

Получает запросы, использующие первичный индекс, из каталога system:completed_requests.

Получить запросы с наибольшим количеством результатов из каталога system:completed_requests.

Получить запросы с наибольшими размерами ответов из каталога system:completed_requests.

Получить схему для коллекции в указанном скоупе. Возвращает словарь с именем коллекции и схемой, полученной при выполнении запроса INFER для коллекции Couchbase.

Получить имена всех scope и collection в bucket. Возвращает словарь, где ключи - имена scope, а значения - списки имён collection.

Получить имена всех scopes в указанном bucket.

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

Выводит список индексов в кластере с возможностью фильтрации по bucket, scope, collection и имени индекса. Фильтры нужно задавать иерархически: для scope требуется bucket, для collection — оба, для индекса — все три. Установите ``return_raw_index_stats=True``, чтобы получить необработанную исходную строку для каждого индекса. Каждый результат содержит: name, definition (выражение CREATE INDEX), status, isPrimary, bucket, scope, collection, lastScanTime. Если обязательное поле отсутствует, запись содержит warning и raw_index_stats. Источник зависит от версии кластера: начиная с v8 запрашивает ``system:indexes`` через query service (ограничено RBAC — подключенный пользователь видит только индексы на keyspaces, к которым у него есть доступ); старые кластеры возвращаются к административному REST API Index Service ``/getIndexStatus``.

Выполняет SQL++ запрос на скоупе и возвращает результаты в виде списка JSON-объектов. Запрос выполняется на указанном скоупе в указанном бакете. В запросе используйте имена коллекций напрямую, без префиксов бакета или скоупа — контекст скоупа устанавливается автоматически. Используйте `named_parameters`, чтобы связать значения с плейсхолдерами `$name` в запросе, вместо того чтобы конкатенировать пользовательский ввод в строку. Это предотвращает SQL++-инъекции. Пример: query = "SELECT * FROM users WHERE age > 18" # Неправильно: "SELECT * FROM bucket.scope.users WHERE age > 18"

Тестирует соединение с кластером Couchbase и опционально с бакетом. Этот инструмент проверяет соединение с кластером и бакетом Couchbase, устанавливая его, если оно еще не установлено. Если имя бакета не указано, он не будет пытаться подключиться к бакету, указанному в настройках MCP-сервера. Возвращает статус подключения и базовую информацию о кластере.