๐๏ธ Couchbase MCP Server for LLMs
Mirror of
MCP-Mirror
README
๐๏ธ Couchbase MCP Server for LLMs
A Model Context Protocol (MCP) server that enables LLMs to interact directly with Couchbase databases on Capella clusters. Query buckets, perform CRUD operations, execute N1QL queries, and manage data seamlessly through natural language.
๐ Quick Start
-
Prerequisites
- Node.js 16 or higher
- A running Couchbase instance on Capella
- Claude Desktop application
-
Installation
Couchbase MCP Server can be installed in two ways:
Option 1: Using NPX (Recommended)
The quickest way to get started is using NPX:
npx -y @couchbasedatabase/couchbase-mcp
Option 2: Manual Installation
If you prefer to clone and run the project manually:
# 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
-
Claude Desktop Integration
Add this configuration to your Claude Desktop config file:
Windows:
%APPDATA%/Claude/claude_desktop_config.json
MacOS:~/Library/Application Support/Claude/claude_desktop_config.json
Option 1: With Package Installation
{ "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>" } } } }
Option 2: With Manual Installation
{ "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>" } } } }
-
Verify Connection
- Restart Claude Desktop
- The Couchbase MCP server tools should now be available in your conversations
๐ Available Tools
Basic Operations
query
: Execute N1QL querieslistBuckets
: List available buckets
Scope Management
createScope
: Create a new scope in a bucketdeleteScope
: Delete an existing scopelistScopes
: List all scopes in a bucket
Collection Management
createCollection
: Create a new collection in a scopedropCollection
: Delete a collection from a scope
Document Operations
createDocument
: Create a new documentgetDocument
: Retrieve a document by IDupdateDocument
: Update an existing documentdeleteDocument
: Delete a document by IDbulkCreateDocuments
: Create multiple documents at once
Index Management
createIndex
: Create a new index on specified fieldscreatePrimaryIndex
: Create a primary index on a collectionlistIndexes
: List all indexes in a bucketdropIndex
: Drop an existing index
Each tool supports optional collection
and scope
parameters for targeting specific data containers.
๐ Security Considerations
- Always use environment variables for sensitive credentials
- Consider running the server behind a reverse proxy for production use
- Implement appropriate access controls and authentication as needed
๐ Examples
Here are some example interactions with Claude using the MCP server:
-
List all buckets:
Could you show me all available buckets in the database?
-
Create a scope and collection:
Create a new scope called "users" and a collection called "profiles" in it
-
Query documents:
Find all users who signed up in the last 30 days
-
Create a document:
Create a new user document with name "John Doe" and email "john@example.com"
๐ค Contribution
Contributions are welcome! Please feel free to submit a Pull Request.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
MCP Package Docs Server
Facilitates LLMs to efficiently access and fetch structured documentation for packages in Go, Python, and NPM, enhancing software development with multi-language support and performance optimization.
Claude Code MCP
An implementation of Claude Code as a Model Context Protocol server that enables using Claude's software engineering capabilities (code generation, editing, reviewing, and file operations) through the standardized MCP interface.
@kazuph/mcp-taskmanager
Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.
Linear MCP Server
Enables interaction with Linear's API for managing issues, teams, and projects programmatically through the Model Context Protocol.
mermaid-mcp-server
A Model Context Protocol (MCP) server that converts Mermaid diagrams to PNG images.
Jira-Context-MCP
MCP server to provide Jira Tickets information to AI coding agents like Cursor

Linear MCP Server
A Model Context Protocol server that integrates with Linear's issue tracking system, allowing LLMs to create, update, search, and comment on Linear issues through natural language interactions.

Sequential Thinking MCP Server
This server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.