Couchbase MCP Server for LLMs

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ónEl 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:

Opción 2: Instalación manual

Si prefiere clonar y ejecutar el proyecto manualmente:

3. Integración de escritorio de ClaudeAgregue 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

Opción 2: Con instalación manual

4. Verificar conexión
   • Reiniciar Claude Desktop
   • Las herramientas del servidor Couchbase MCP ahora deberían estar disponibles en tus conversaciones

📝 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.