什麼是Couchbase MCP Server?

Couchbase MCP Server是基於Model Context Protocol(MCP)的服務器，允許用戶通過自然語言(如英語)與Couchbase數據庫交互。它將您的自然語言請求轉換為SQL++查詢，執行並返回結果。

如何使用Couchbase MCP Server?

您需要安裝服務器並與MCP客戶端(如Claude Desktop)配合使用。通過簡單的英語命令即可查詢數據庫，無需編寫複雜的SQL++語句。

適用場景

適用於需要快速查詢Couchbase數據庫但不想編寫複雜查詢的用戶，或希望用自然語言探索數據的場景。

主要功能

Couchbase查詢工具執行SQL++查詢語句並返回結果，支持自然語言轉換為查詢

優勢與侷限性

優勢

無需學習SQL++語法，使用自然語言即可查詢

與Claude Desktop等MCP客戶端無縫集成

簡化數據庫探索過程

侷限性

需要預先配置Couchbase連接

目前只支持SQL++查詢功能

依賴MCP客戶端使用

如何使用

安裝依賴

克隆倉庫並安裝所需依賴

配置環境

創建.env文件並添加Couchbase連接信息

構建並運行

構建項目並啟動MCP服務器

使用案例

簡單數據瀏覽快速查看數據庫中的樣本數據

業務數據摘要獲取業務數據的摘要信息

常見問題

需要什麼客戶端才能使用這個服務器?

支持哪些Couchbase版本?

如何調試問題?

🚀 Couchbase MCP 服務器

模型上下文協議 (MCP) 是一種用於處理大型語言模型 (LLMs) 與外部系統之間交互的協議。本項目使用 Couchbase Node.js SDK 實現了一個 Couchbase MCP 服務器，讓 MCP 客戶端（如 Claude Desktop）能夠對 Couchbase Capella 集群執行自然語言查詢。

🚀 快速開始

藉助此服務器，您可以使用以下命令：

Show me the results of SELECT * FROM my_bucket LIMIT 10
Execute this query: SELECT name, age FROM users WHERE active = true
Get me the latest 5 documents from my_bucket
Summarize the latest 5 orders from the orders bucket for me

✨ 主要特性

Couchbase 查詢工具

工具名稱：query-couchbase
描述：在您的 Couchbase Capella 集群上執行 SQL++ 查詢語句。
用法：調用時，服務器將使用 Couchbase Node.js SDK 執行提供的 SQL++ 查詢並返回結果。

📦 安裝指南

克隆倉庫並安裝依賴項：

git clone git@github.com:hummusonrails/couchbase-mcp-server.git
cd couchbase-mcp-server
npm install

在根目錄下創建一個 .env 文件，並添加您的 Couchbase 連接字符串、用戶名和密碼：

COUCHBASE_CONNECTION_STRING=couchbases://your-cluster.cloud.couchbase.com
COUCHBASE_USERNAME=your_username
COUCHBASE_PASSWORD=your_password

請參考 .env.sample 文件以獲取所需的環境變量。 3. 構建項目：

npm run build

使用 Stdio 傳輸運行服務器：

npx couchbase-mcp-server

⚠️ 重要提示

MCP 服務器使用 StdioServerTransport，因此它通過標準輸入/輸出進行通信。請確保您的 MCP 客戶端（例如 Claude Desktop）配置為連接到本地 MCP 服務器。請按照 Claude Desktop 文檔配置您的 MCP 客戶端以連接到本地服務器。