
aniket310101/mcp-server-couchbase
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
A Model Context Protocol (MCP) server that enables LLMs to interact directly with Couchbase databases. Query buckets, execute N1QL queries, and manage data seamlessly through natural language.
개요
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. - Node.js 16 or higher - A running Couchbase instance on Capella - Claude Desktop application Couchbase MCP Server can be installed in two ways: The quickest way to get started is using NPX: If you prefer to clone and run the project manually: Add this configuration to your Claude Desktop config file: : %APPDATA%/Claude/claude_desktop_config.json : ~/Library/Application Support/Claude/claude_desktop_config.json - Restart Claude Desktop - The Couchbase MCP server tools should now be available in your conversations
README
원문 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-mcpOption 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.jsonOption 1: With Package Installation
{ "mcpServers": { "couchbase": { "command": "npx", "args": ["-y", "@couchbasedatabase/couchbase-mcp"], "env": { "COUCHBASE_URL": "", "COUCHBASE_BUCKET": "", "COUCHBASE_USERNAME": "", "COUCHBASE_PASSWORD": "" } } } }Option 2: With Manual Installation
{ "mcpServers": { "couchbase": { "command": "node", "args": ["path/to/MCP-Server-Couchbase/dist/index.js"], "env": { "COUCHBASE_URL": "", "COUCHBASE_BUCKET": "", "COUCHBASE_USERNAME": "", "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 document
설치
npx -y @couchbasedatabase/couchbase-mcp설정
{
"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>"
}
}
}
}