Servidor MCP de Couchbase | Awesome MCP Servers

🗄️ Servidor MCP de Couchbase para LLMs

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

🚀 Inicio Rápido

Requisitos previos
- Node.js 16 o superior
- Una instancia de Couchbase en ejecución en Capella
- Aplicación de Claude Desktop
Instalación

El Servidor MCP de Couchbase se puede instalar de dos maneras:

Opción 1: Usando NPX (Recomendado)

La forma más rápida de comenzar es usando NPX:
```
npx -y @couchbasedatabase/couchbase-mcp
```
Opción 2: Instalación Manual

Si prefieres 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
```

Integración con Claude Desktop

Agrega esta configuración a tu archivo de configuración de Claude Desktop:

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

Opción 1: Con Instalación de Paquete

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

Verificar la Conexión
- Reinicia Claude Desktop
- Las herramientas del servidor MCP de Couchbase deberían estar ahora disponibles en tus conversaciones

📝 Herramientas Disponibles

Operaciones Básicas

query: Ejecutar consultas N1QL
listBuckets: Listar buckets disponibles

Gestión de Scopes

createScope: Crear un nuevo scope en un bucket
deleteScope: Eliminar un scope existente
listScopes: Listar todos los scopes en un bucket

Gestión de Colecciones

createCollection: Crear una nueva colección en un scope
dropCollection: Eliminar una colección de un scope

Operaciones de Documentos

createDocument: Crear un nuevo documento
getDocument: Recuperar un documento por ID
updateDocument: Actualizar un documento existente
deleteDocument: Eliminar un documento por ID
bulkCreateDocuments: Crear múltiples documentos a la vez

Gestión de Índices

createIndex: Crear un nuevo índice en campos especificados
createPrimaryIndex: Crear un índice primario en una colección
listIndexes: Listar todos los índices en un bucket
dropIndex: Eliminar un índice existente

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

🔒 Consideraciones de Seguridad

Siempre usa variables de entorno para credenciales sensibles
Considera ejecutar el servidor detrás de un proxy inverso para uso en producción
Implementa controles de acceso y autenticación apropiados según sea necesario

📚 Ejemplos

Aquí hay algunos ejemplos de interacciones con Claude usando el servidor MCP:

Listar todos los buckets:

Could you show me all available buckets in the database?

Crear un scope y una colección:

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

Consultar documentos:

Find all users who signed up in the last 30 days

Crear un documento:

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

🤝 Contribución

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción (Pull Request).

Couchbase

Documentación