🚀 🗓️ 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_BUCKET": "<存储桶名称>",
"COUCHBASE_USERNAME": "" ,
"COUCHBASE_PASSWORD": ""
}
}
}
}
方案 2：使用手动安装
{
"mcpServers": {
"couchbase": {
"command": "node",
"args": ["path/to/MCP-Server-Couchbase/dist/index.js"],
"env": {
"COUCHBASE_URL": "" ,
"COUCHBASE_BUCKET": "<存储桶名称>",
"COUCHBASE_USERNAME": "" ,
"COUCHBASE_PASSWORD": ""
}
}
}
}
验证连接
- 重启 Claude Desktop
- Couchbase MCP 服务器工具现在应在您的对话中可用
✨ 主要特性
- 执行 N1QL 查询：通过语言指令查询和操作数据库。
- 管理存储桶和数据：创建、读取、更新和删除存储桶及其中的数据。
- 配置连接参数：设置必要的环境变量以建立与 Couchbase 服务器的连接。
💻 使用示例
基础用法
创建存储桶
创建名为 "my_bucket" 的新存储桶。
删除文档
删除存储桶 "my_bucket" 中的文档 "_user/123".
更新数据
将存储桶 "my_bucket" 中键为 "_product/456" 的值更新为 {"name": "New Product", "price": 99.99}.
🚧 注意事项
⚠️ 重要提示
确保所有环境变量正确无误，特别是身份验证信息。
💡 使用建议
在生产环境中使用前，请测试所有功能以确保正常运行。
通过以上步骤，您可以轻松地与 Couchbase 数据库交互，无需编写代码即可完成复杂的数据操作。