Servidor MCP Couchbase | Awesome MCP Servers

🗄️ Servidor MCP Couchbase para LLMs

Um servidor Model Context Protocol (MCP) que permite que LLMs interajam diretamente com bancos de dados Couchbase em clusters Capella. Consulte buckets, execute operações CRUD, execute consultas N1QL e gerencie dados perfeitamente por meio de linguagem natural.

🚀 Início Rápido

Pré-requisitos
- Node.js 16 ou superior
- Uma instância Couchbase em execução no Capella
- Aplicativo Claude Desktop
Instalação

O Servidor MCP Couchbase pode ser instalado de duas maneiras:

Opção 1: Usando NPX (Recomendado)

A maneira mais rápida de começar é usando NPX:
```
npx -y @couchbasedatabase/couchbase-mcp
```
Opção 2: Instalação Manual

Se você preferir clonar e executar o projeto 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
```

Integração com Claude Desktop

Adicione esta configuração ao seu arquivo de configuração do Claude Desktop:

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

Opção 1: Com Instalação do Pacote

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

Opção 2: Com Instalação 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 Conexão
- Reinicie o Claude Desktop
- As ferramentas do servidor MCP Couchbase agora devem estar disponíveis em suas conversas

📝 Ferramentas Disponíveis

Operações Básicas

query: Executar consultas N1QL
listBuckets: Listar buckets disponíveis

Gerenciamento de Escopos

createScope: Criar um novo escopo em um bucket
deleteScope: Excluir um escopo existente
listScopes: Listar todos os escopos em um bucket

Gerenciamento de Coleções

createCollection: Criar uma nova coleção em um escopo
dropCollection: Excluir uma coleção de um escopo

Operações de Documentos

createDocument: Criar um novo documento
getDocument: Recuperar um documento por ID
updateDocument: Atualizar um documento existente
deleteDocument: Excluir um documento por ID
bulkCreateDocuments: Criar vários documentos de uma vez

Gerenciamento de Índices

createIndex: Criar um novo índice em campos especificados
createPrimaryIndex: Criar um índice primário em uma coleção
listIndexes: Listar todos os índices em um bucket
dropIndex: Remover um índice existente

Cada ferramenta suporta parâmetros opcionais collection e scope para direcionar contêineres de dados específicos.

🔒 Considerações de Segurança

Sempre use variáveis de ambiente para credenciais sensíveis
Considere executar o servidor atrás de um proxy reverso para uso em produção
Implemente controles de acesso e autenticação apropriados conforme necessário

📚 Exemplos

Aqui estão alguns exemplos de interações com Claude usando o servidor MCP:

Listar todos os buckets:

Could you show me all available buckets in the database?

Criar um escopo e uma coleção:

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

Criar um documento:

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

🤝 Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Couchbase

Documentação