什么是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 客户端以连接到本地服务器。