Servidor Couchbase MCP para LLM

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los LLM interactuar directamente con las bases de datos de Couchbase en clústeres de Capella. Consulta buckets, realiza operaciones CRUD, ejecuta consultas N1QL y gestiona datos de forma fluida mediante lenguaje natural.

🚀 Inicio rápido

1. Prerrequisitos

   • Node.js 16 o superior

   • Una instancia de Couchbase en ejecución en Capella

   • Aplicación de escritorio Claude

2. Instalación

   El servidor Couchbase MCP se puede instalar de dos maneras:

Opción 1: Usar NPX (recomendado)

La forma más rápida de comenzar es utilizando NPX:

npx -y @couchbasedatabase/couchbase-mcp

Opción 2: Instalación manual

Si prefiere clonar y ejecutar el proyecto manualmente:

# 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. Integración de escritorio de Claude

   Agregue esta configuración a su archivo de configuración de Claude Desktop:

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

Opción 1: Con instalación de paquetes

{
  "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>"
      }
    }
  }
}

Opción 2: Con instalación manual

{
  "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. Verificar conexión

   • Reiniciar Claude Desktop

   • Las herramientas del servidor Couchbase MCP ahora deberían estar disponibles en tus conversaciones

Related MCP server: Couchbase MCP Server

📝 Herramientas disponibles

Operaciones básicas

• query : Ejecutar consultas N1QL

• listBuckets : Lista de los buckets disponibles

Gestión del alcance

• createScope : Crea un nuevo alcance en un depósito

• deleteScope : eliminar un ámbito existente

• listScopes : enumera todos los ámbitos en un depósito

Gestión de cobros

• createCollection : Crea una nueva colección en un ámbito

• dropCollection : eliminar una colección de un ámbito

Operaciones de documentos

• createDocument : Crea un nuevo documento

• getDocument : Recuperar un documento por ID

• updateDocument : Actualizar un documento existente

• deleteDocument : Eliminar un documento por ID

• bulkCreateDocuments : crea varios documentos a la vez

Gestión de índices

• createIndex : Crea un nuevo índice en los campos especificados

• createPrimaryIndex : Crea un índice primario en una colección

• listIndexes : enumera todos los índices en un depósito

• dropIndex : Elimina un índice existente

Cada herramienta admite parámetros collection y scope opcionales para apuntar a contenedores de datos específicos.

Consideraciones de seguridad

• Utilice siempre variables de entorno para credenciales confidenciales

• Considere ejecutar el servidor detrás de un proxy inverso para uso en producción

• Implementar controles de acceso y autenticación adecuados según sea necesario

📚 Ejemplos

A continuación se muestran algunos ejemplos de interacciones con Claude utilizando el servidor MCP:

1. Enumere todos los depósitos:

   Could you show me all available buckets in the database?

2. Crear un alcance y una colección:

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

3. Consulta de documentos:

   Find all users who signed up in the last 30 days

4. Crear un documento:

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

🤝 Contribución

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.