aniket310101/mcp-server-couchbase

本页由 AI 翻译，技术细节请以原文为准。查看原文

7 stars 6 forks 质量 54 趋势 15

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

🚀 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_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 queries
listBuckets: List available buckets

Scope Management

createScope: Create a new scope in a bucket
deleteScope: Delete an existing scope
listScopes: List all scopes in a bucket

Collection Management

createCollection: Create a new collection in a scope
dropCollection: Delete a collection from a scope

Document Operations

createDocument: Create a new document
getDocument: Retrieve a document by ID
updateDocument: Update an existing document

在 GitHub 查看完整 README

安装

npx -y @couchbasedatabase/couchbase-mcp

新手？先看 mcpskill.org 教程 →

配置

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