MCP Server Couchbase

🚀 🗓️ Couchbase MCP 服務器用於 LLMs

Couchbase MCP 服務器是一個模型上下文協議（MCP）服務器，它讓大語言模型（LLM）能夠直接與 Capella 集群上的 Couchbase 數據庫進行交互。藉助該服務器，用戶可以通過自然語言無縫地查詢存儲桶、執行 CRUD 操作、運行 N1QL 查詢以及管理數據。

🚀 快速開始

先決條件

• Node.js 16 或更高版本
• 正在運行的 Couchbase 實例（Capella）
• Claude Desktop 應用程序

安裝

Couchbase MCP 服務器提供了兩種安裝方式：

方案 1：使用 NPX（推薦）

通過 NPX 安裝是最快的方式：

npx -y @couchbasedatabase/couchbase-mcp

方案 2：手動安裝

若您傾向於克隆並運行項目，可按以下步驟操作：

# 克隆倉庫
git clone https://github.com/Aniket310101/MCP-Server-Couchbase.git
cd MCP-Server-Couchbase

# 安裝依賴項
npm install

# 構建項目
npm run build

Claude Desktop 集成

將以下配置添加到您的 Claude Desktop 配置文件中：

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

方案 1：使用包安裝

{
  "mcpServers": {
    "couchbase": {
      "command": "npx",
      "args": ["-y", "@couchbasedatabase/couchbase-mcp"],
      "env": {
        "COUCHBASE_URL": "<COUCHBASE 連接字符串>",
        "COUCHBASE_BUCKET": "<存儲桶名稱>",
        "COUCHBASE_USERNAME": "<Couchbase 用戶名>",
        "COUCHBASE_PASSWORD": "<Couchbase 密碼>"
      }
    }
  }
}

方案 2：使用手動安裝

{
  "mcpServers": {
    "couchbase": {
      "command": "node",
      "args": ["path/to/MCP-Server-Couchbase/dist/index.js"],
      "env": {
        "COUCHBASE_URL": "<COUCHBASE 連接字符串>",
        "COUCHBASE_BUCKET": "<存儲桶名稱>",
        "COUCHBASE_USERNAME": "<Couchbase 用戶名>",
        "COUCHBASE_PASSWORD": "<Couchbase 密碼>"
      }
    }
  }
}

驗證連接

• 重啟 Claude Desktop
• Couchbase MCP 服務器工具現在應在您的對話中可用

✨ 主要特性

• 執行 N1QL 查詢：通過語言指令查詢和操作數據庫。
• 管理存儲桶和數據：創建、讀取、更新和刪除存儲桶及其中的數據。
• 配置連接參數：設置必要的環境變量以建立與 Couchbase 服務器的連接。

💻 使用示例

基礎用法

創建存儲桶

創建名為 "my_bucket" 的新存儲桶。

刪除文檔

刪除存儲桶 "my_bucket" 中的文檔 "_user/123".

更新數據

將存儲桶 "my_bucket" 中鍵為 "_product/456" 的值更新為 {"name": "New Product", "price": 99.99}.

🚧 注意事項

⚠️ 重要提示

確保所有環境變量正確無誤，特別是身份驗證信息。

💡 使用建議

在生產環境中使用前，請測試所有功能以確保正常運行。

通過以上步驟，您可以輕鬆地與 Couchbase 數據庫交互，無需編寫代碼即可完成複雜的數據操作。