Couchbase MCP Server

基本能力

产品定位

Couchbase MCP Server 是一个数据库交互工具，旨在通过 MCP 协议使 LLMs 能够直接与 Couchbase 集群进行交互。

核心功能

• 获取指定 Couchbase 集群桶中的所有作用域和集合列表
• 获取 Couchbase 集群中集合的结构
• 对 Couchbase 集群桶中的数据执行 SQL++ 查询

适用场景

• 开发者在开发过程中需要与 Couchbase 集群进行交互
• 数据分析师需要对 Couchbase 集群中的数据进行查询和分析
• 需要将 LLMs 与 Couchbase 集群集成的应用场景

工具列表

• uv: 用于运行服务器的 Python 包管理器
• Claude Desktop: 一个 MCP 客户端，用于连接服务器到 Claude
• Cursor: 另一个支持 MCP 的客户端

常见问题解答

• 确保 MCP 服务器仓库的路径在配置中正确
• 验证 Couchbase 连接字符串、用户名、密码和桶名是否正确
• 如果使用 Couchbase Capella，确保集群可以从运行 MCP 服务器的机器访问
• 检查数据库用户是否有访问指定桶的权限
• 确认 uv 包管理器已正确安装并可访问

使用教程

使用依赖

• Python 3.10 或更高版本
• 运行的 Couchbase 集群
• 安装 uv 包管理器

安装教程

1. 克隆仓库到本地机器

git clone https://github.com/Couchbase-Ecosystem/mcp-server-couchbase.git

1. 配置环境变量
2. CB_CONNECTION_STRING: Couchbase 集群的连接字符串
3. CB_USERNAME: 用于连接的用户名
4. CB_PASSWORD: 用户的密码
5. CB_BUCKET_NAME: 服务器将访问的桶名

调试方式

• 检查日志文件 mcp-server-couchbase.log 以诊断问题
• 在 Claude Desktop 或 Cursor 中查看 MCP 服务器日志

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。