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 через run_sql_plus_plus_query.

Получает запросы, использующие первичный индекс, из каталога 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.

Ищет части документа без загрузки целиком, используя поддокументные операции Couchbase. Используй это вместо get_document_by_id, когда нужны всего несколько полей, проверка наличия или размер массива/объекта внутри документа — И ты уже знаешь точные пути к полям для поиска (например, из предыдущего вызова get_document_by_id по этому же документу, из явно названного пользователем поля или из известной/подтверждённой схемы для этой коллекции). ВАЖНО: Не угадывай пути к полям. Если ты ещё не знаешь точные имена/структуру полей документа, сначала (или вместо этого) вызови get_document_by_id — угаданный путь, который не существует, вернёт по нему ошибку, а не настоящие данные, и сообщать «не найдено» для неверной догадки хуже, чем просто загрузить весь документ и прочитать правильное поле. Укажи один или несколько из следующих параметров. Каждый — список путей к поддокументам в синтаксисе Couchbase с точками/скобками (например, "address.city", "tags[0]", "tags[-1]" для последнего элемента массива): - get_paths: получает ЗНАЧЕНИЕ по каждому пути. - exists_paths: проверяет, существует ли каждый путь, не получая его значение (дешевле, чем get_paths — нет передачи содержимого — когда нужен только ответ да/нет). - count_paths: возвращает количество элементов в массиве или объекте по каждому пути (возвращает ошибку для этого пути, если путь не является массивом/объектом). Хотя бы один из get_paths, exists_paths или count_paths должен быть указан. По общему правилу, старайся, чтобы общее количество путей во всех трёх не превышало 16 — Couchbase ограничивает количество поддокументных операций за вызов, хотя точный лимит устанавливается на стороне сервера и может измениться. Если сервер отклоняет вызов (слишком много путей или другое ограничение, например длина пути или глубина вложенности), весь вызов завершается ошибкой с {"error": "..."}. Путь, который не существует (или завершается ошибкой, например count на не-массиве/объекте), НЕ приводит к сбою всего вызова — по нему возвращается отдельная ошибка {"error": ...} в возвращаемом словаре, чтобы остальные запрошенные пути могли быть обработаны.

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

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