金大哥 - MCP-Server-Couchbase MCP 详情

article

README

🚀 🗓️ Couchbase MCP 服务器用于 LLMs

Couchbase MCP 服务器是一个模型上下文协议（MCP）服务器，它让大语言模型（LLM）能够直接与 Capella 集群上的 Couchbase 数据库进行交互。借助该服务器，用户可以通过自然语言无缝地查询存储桶、执行 CRUD 操作、运行 N1QL 查询以及管理数据。

🚀 快速开始

先决条件

Node.js 16 或更高版本
正在运行的 Couchbase 实例（Capella）
Claude Desktop 应用程序

安装

Couchbase MCP 服务器提供了两种安装方式：

方案 1：使用 NPX（推荐）

通过 NPX 安装是最快的方式：

npx -y @couchbasedatabase/couchbase-mcp

方案 2：手动安装

若您倾向于克隆并运行项目，可按以下步骤操作：

# 克隆仓库
git clone https://github.com/Aniket310101/MCP-Server-Couchbase.git
cd MCP-Server-Couchbase

# 安装依赖项
npm install

# 构建项目
npm run build

Claude Desktop 集成

将以下配置添加到您的 Claude Desktop 配置文件中：

Windows：%APPDATA%/Claude/claude_desktop_config.json
MacOS：~/Library/Application Support/Claude/claude_desktop_config.json

方案 1：使用包安装

{
  "mcpServers": {
    "couchbase": {
      "command": "npx",
      "args": ["-y", "@couchbasedatabase/couchbase-mcp"],
      "env": {
        "COUCHBASE_URL": "<COUCHBASE 连接字符串>",
        "COUCHBASE_BUCKET": "<存储桶名称>",
        "COUCHBASE_USERNAME": "<Couchbase 用户名>",
        "COUCHBASE_PASSWORD": "<Couchbase 密码>"
      }
    }
  }
}

方案 2：使用手动安装

{
  "mcpServers": {
    "couchbase": {
      "command": "node",
      "args": ["path/to/MCP-Server-Couchbase/dist/index.js"],
      "env": {
        "COUCHBASE_URL": "<COUCHBASE 连接字符串>",
        "COUCHBASE_BUCKET": "<存储桶名称>",
        "COUCHBASE_USERNAME": "<Couchbase 用户名>",
        "COUCHBASE_PASSWORD": "<Couchbase 密码>"
      }
    }
  }
}

验证连接

重启 Claude Desktop
Couchbase MCP 服务器工具现在应在您的对话中可用

✨ 主要特性

执行 N1QL 查询：通过语言指令查询和操作数据库。
管理存储桶和数据：创建、读取、更新和删除存储桶及其中的数据。
配置连接参数：设置必要的环境变量以建立与 Couchbase 服务器的连接。

💻 使用示例

基础用法

创建存储桶

创建名为 "my_bucket" 的新存储桶。

删除文档

删除存储桶 "my_bucket" 中的文档 "_user/123".

更新数据

将存储桶 "my_bucket" 中键为 "_product/456" 的值更新为 {"name": "New Product", "price": 99.99}.

🚧 注意事项

⚠️ 重要提示

确保所有环境变量正确无误，特别是身份验证信息。

💡 使用建议

在生产环境中使用前，请测试所有功能以确保正常运行。

通过以上步骤，您可以轻松地与 Couchbase 数据库交互，无需编写代码即可完成复杂的数据操作。

MCP-Server-Couchbase