local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Supports configuration through environment variables in a .env file, enabling secure storage of Couchbase credentials.
Enables interaction with Couchbase databases, allowing querying buckets, performing CRUD operations on documents, managing scopes and collections, executing N1QL queries, and handling index operations.
Uses Git for version control and installation through the git clone command.

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

Prerrequisitos
- Node.js 16 o superior
- Una instancia de Couchbase en ejecución en Capella
- Aplicación de escritorio Claude
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:

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

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

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

Enumere todos los depósitos:
Could you show me all available buckets in the database?
Crear un alcance y una colección:
Create a new scope called "users" and a collection called "profiles" in it
Consulta de 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

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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Un servidor de protocolo de contexto de modelo que permite que grandes modelos de lenguaje interactúen directamente con bases de datos de Couchbase a través del lenguaje natural, admitiendo operaciones como consultas de contenedores, realización de operaciones CRUD y ejecución de consultas N1QL.

Couchbase MCP Server for LLMs