Couchbase MCP Server
2025.03.25
1
JavaScript数据库查询工具自然语言查询数据库
Couchbase MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，用于处理大型语言模型 (LLMs) 与外部系统之间的交互。它使用 Couchbase Node.js SDK，使 MCP 客户端（如 Claude Desktop）能够对 Couchbase Capella 集群执行自然语言查询。
View on GitHub
Overview
基本能力
产品定位
Couchbase MCP Server 是一个数据库查询工具，允许用户通过自然语言查询 Couchbase Capella 集群中的数据。
核心功能
- 自然语言查询转换：将用户的自然语言请求转换为 SQL++ 查询语句。
- Couchbase 查询执行：使用 Couchbase Node.js SDK 执行 SQL++ 查询并返回结果。
- 结果格式化：将查询结果以可读格式返回给用户。
适用场景
- 用户需要通过自然语言查询 Couchbase 数据库的场景。
- 开发者在开发过程中需要快速查询数据库数据的场景。
- 数据分析师需要快速获取数据库汇总信息的场景。
工具列表
- query-couchbase
- 能力：执行 SQL++ 查询语句并返回结果。
常见问题解答
- 如何配置 MCP 客户端？
- 参考 Claude Desktop 文档 配置 MCP 客户端连接到本地服务器。
- 如何调试？
- 所有日志消息都发送到
stderr，可以检查日志以获取详细的连接和错误消息。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm。
安装教程
- 克隆仓库并安装依赖：
git clone [email protected]: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
- 构建项目：
npm run build
- 运行服务器：
npx couchbase-mcp-server
调试方式
- 检查
stderr日志以获取详细的连接和错误消息。 - 使用 MCP 客户端（如 Claude Desktop）测试查询功能。