🗄️ Couchbase MCP Server для LLM

Сервер Model Context Protocol (MCP), который позволяет LLM напрямую взаимодействовать с базами данных Couchbase на кластерах Capella. Запрашивайте сегменты, выполняйте операции CRUD, выполняйте запросы N1QL и управляйте данными без проблем с помощью естественного языка.

🚀 Быстрый старт

1. Предпосылки

   • Node.js 16 или выше

   • Работающий экземпляр Couchbase на Capella

   • Клод Приложение для рабочего стола

2. Установка

   Couchbase MCP Server можно установить двумя способами:

Вариант 1: использование NPX (рекомендуется)

Самый быстрый способ начать работу — использовать NPX:

npx -y @couchbasedatabase/couchbase-mcp

Вариант 2: Ручная установка

Если вы предпочитаете клонировать и запустить проект вручную:

# Clone the repository
git clone https://github.com/Aniket310101/MCP-Server-Couchbase.git
cd MCP-Server-Couchbase

# Install dependencies
npm install

# Build the project
npm run build

3. Интеграция рабочего стола Клода

   Добавьте эту конфигурацию в файл конфигурации Claude Desktop:

   Windows : %APPDATA%/Claude/claude_desktop_config.json
   MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json

Вариант 1: С установкой пакета

{
  "mcpServers": {
    "couchbase": {
      "command": "npx",
      "args": ["-y", "@couchbasedatabase/couchbase-mcp"],
      "env": {
        "COUCHBASE_URL": "<COUCHBASE CONNECTION STRING>",
        "COUCHBASE_BUCKET": "<BUCKET NAME>",
        "COUCHBASE_USERNAME": "<COUCHBASE USERNAME>",
        "COUCHBASE_PASSWORD": "<COUCHBASE PASSWORD>"
      }
    }
  }
}

Вариант 2: С ручной установкой

{
  "mcpServers": {
    "couchbase": {
      "command": "node",
      "args": ["path/to/MCP-Server-Couchbase/dist/index.js"],
      "env": {
        "COUCHBASE_URL": "<COUCHBASE CONNECTION STRING>",
        "COUCHBASE_BUCKET": "<BUCKET NAME>",
        "COUCHBASE_USERNAME": "<COUCHBASE USERNAME>",
        "COUCHBASE_PASSWORD": "<COUCHBASE PASSWORD>"
      }
    }
  }
}

4. Проверить соединение

   • Перезагрузить рабочий стол Клода

   • Инструменты сервера Couchbase MCP теперь должны быть доступны в ваших разговорах.

Related MCP server: MCP TapData Server

📝 Доступные инструменты

Основные операции

• query : выполнение запросов N1QL

• listBuckets : Список доступных контейнеров

Управление областью действия

• createScope : создать новую область в контейнере

• deleteScope : Удалить существующую область действия

• listScopes : список всех областей в корзине

Управление коллекциями

• createCollection : Создать новую коллекцию в области действия

• dropCollection : Удалить коллекцию из области действия

Операции с документами

• createDocument : Создать новый документ

• getDocument : Получить документ по идентификатору

• updateDocument : Обновить существующий документ

• deleteDocument : Удалить документ по идентификатору

• bulkCreateDocuments : создание нескольких документов одновременно

Управление индексом

• createIndex : создать новый индекс по указанным полям

• createPrimaryIndex : создание первичного индекса для коллекции

• listIndexes : список всех индексов в корзине

• dropIndex : Удалить существующий индекс

Каждый инструмент поддерживает дополнительные параметры collection и scope для нацеливания на определенные контейнеры данных.

🔒 Вопросы безопасности

• Всегда используйте переменные среды для конфиденциальных учетных данных.

• Рассмотрите возможность запуска сервера через обратный прокси-сервер для использования в производственных целях.

• При необходимости внедрите соответствующий контроль доступа и аутентификацию.

📚 Примеры

Вот несколько примеров взаимодействия с Клодом с использованием сервера MCP:

1. Список всех ведер:

   Could you show me all available buckets in the database?

2. Создайте область и коллекцию:

   Create a new scope called "users" and a collection called "profiles" in it

3. Запросить документы:

   Find all users who signed up in the last 30 days

4. Создать документ:

   Create a new user document with name "John Doe" and email "john@example.com"

🤝 Вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

🛡️ Значок оценки безопасности (MseeP.ai)