MCP 服务器

Couchbase MCP Server

Couchbase-Ecosystem

开发者工具

访问服务器

README

Couchbase MCP 服务器

一个 Couchbase 的 MCP 服务器实现，允许 LLM 直接与 Couchbase 集群交互。

功能

获取 Couchbase 集群中指定 bucket 的所有 scope 和 collection 的列表
获取 Couchbase 集群中 collection 的结构
针对 Couchbase 集群 bucket 中的数据运行 SQL++ 查询

前提条件

Python 3.10 或更高版本。
一个正在运行的 Couchbase 集群。最简单的入门方法是使用 Capella 免费层，它是 Couchbase 服务器的完全托管版本。您可以按照说明导入其中一个示例数据集或导入您自己的数据集。
安装 uv 以运行服务器。
一个 MCP 客户端，例如 Claude Desktop，用于将服务器连接到 Claude。提供了 Claude Desktop 和 Cursor 的说明。也可以使用其他 MCP 客户端。

配置

将存储库克隆到您的本地计算机。

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

Claude Desktop

按照以下步骤将 Couchbase MCP 服务器与 Claude Desktop MCP 客户端一起使用

现在可以通过编辑配置文件将 MCP 服务器添加到 Claude Desktop。可以在 MCP 快速入门指南上找到更详细的说明。
- 在 Mac 上，配置文件位于 ~/Library/Application Support/Claude/claude_desktop_config.json
- 在 Windows 上，配置文件位于 %APPDATA%\Claude\claude_desktop_config.json
打开配置文件并将以下配置添加到 mcpServers 部分：
```
{
  "mcpServers": {
    "couchbase": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/cloned/repo/mcp-server-couchbase/",
        "run",
        "src/mcp_server.py"
      ],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_USERNAME": "username",
        "CB_PASSWORD": "password",
        "CB_BUCKET_NAME": "bucket_name"
      }
    }
  }
}
```
可以使用环境变量配置服务器。支持以下变量：
- CB_CONNECTION_STRING：到 Couchbase 集群的连接字符串
- CB_USERNAME：具有访问要使用的 bucket 的权限的用户名
- CB_PASSWORD：用于连接的用户名密码
- CB_BUCKET_NAME：服务器将访问的 bucket 的名称
- path/to/cloned/repo/mcp-server-couchbase/ 应该是本地计算机上克隆存储库的路径。不要忘记末尾的斜杠！
重新启动 Claude Desktop 以应用更改。
现在，您可以使用 Claude Desktop 中的服务器来使用自然语言在 Couchbase 集群上运行查询。

Claude Desktop 日志

Claude Desktop 的日志可以在以下位置找到：

MacOS: ~/Library/Logs/Claude
Windows: %APPDATA%\Claude\Logs

日志可用于诊断连接问题或 MCP 服务器配置的其他问题。有关更多详细信息，请参阅官方文档。

Cursor

按照以下步骤将 Couchbase MCP 服务器与 Cursor 一起使用：

在您的机器上安装 Cursor。
在 Cursor 中，转到 Cursor > Cursor Settings > MCP > Add a new global MCP server。另请查看 Cursor 中关于设置 MCP 服务器配置的文档。
指定与上面相同的配置。您可能需要在 mcpServers 的父键下添加服务器配置，如下所示。

{
  "mcpServers": {
    "couchbase": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/cloned/repo/mcp-server-couchbase/",
        "run",
        "src/mcp_server.py"
      ],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_USERNAME": "username",
        "CB_PASSWORD": "password",
        "CB_BUCKET_NAME": "bucket_name"
      }
    }
  }
}