MCP Server Couchbase

🚀 用於大語言模型的 Couchbase MCP 服務器

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 服務器應該已成功集成

✨ 主要特性

以下是該服務器支持的一些操作：

• list buckets：列出所有存儲桶
• describe bucket <name>：描述指定存儲桶的詳細信息
• create bucket <name> <type>：創建新存儲桶
• delete bucket <name>：刪除指定存儲桶
• query <sql-query>：執行 N1QL 查詢

🔧 技術細節

安全考量

• 環境變量：敏感信息（如密碼）應通過環境變量提供，避免硬編碼。
• 反向代理：在生產環境中，建議使用反向代理（如 Nginx）來處理 HTTPS 請求，並限制對 MCP 服務器的訪問。

💻 使用示例

基礎用法

以下是一些使用示例：

# 列出所有存儲桶
list buckets

# 描述指定存儲桶
describe bucket my_bucket

# 創建新存儲桶
create bucket my_new_bucket Couchbase

# 刪除存儲桶
delete bucket old_bucket

# 執行 N1QL 查詢
query SELECT * FROM my_bucket LIMIT 10

🤝 貢獻

我們歡迎社區的貢獻！如果您發現任何問題或有任何改進建議，請訪問我們的 GitHub 倉庫：MCP-Server-Couchbase。

感謝您的支持和幫助，讓我們一起使這個項目更加完善！