🗄️ LLM的Couchbase MCP服务器
一种模型上下文协议（MCP）服务器，使LLM能够直接与Capella集群上的Couchbase数据库交互。查询bucket，执行CRUD操作，执行N1QL查询，并通过自然语言无缝管理数据。
🚀 快速开始
- 先决条件
- Node.js 16或更高版本 - Capella上正在运行的Couchbase实例 - Claude桌面应用程序
- 安装
Couchbase MCP服务器可以通过两种方式安装：
### 选项1：使用NPX（推荐）
最快的入门方法是使用NPX：
npx -y @couchbasedatabase/couchbase-mcp### 选项2：手动安装
如果您更喜欢手动克隆和运行项目：
# Clone the repository
git clone https://github.com/Aniket310101/MCP-Server-Couchbase.git
cd MCP-Server-Couchbase
# Install dependencies
npm install
# Build the project
npm run build- Claude桌面集成
将此配置添加到您的Claude Desktop配置文件中：
视窗: %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": ""
}
}
}
}- 验证连接
- 重新启动克劳德桌面 - Couchbase MCP服务器工具现在应该可以在您的对话中使用了
📝 可用工具
基本操作
query：执行N1QL查询listBuckets：列出可用桶
范围管理
createScope：在bucket中创建新作用域deleteScope：删除现有作用域listScopes：列出bucket中的所有作用域
收集管理
createCollection：在作用域中创建新集合dropCollection：从作用域中删除集合
文档操作
createDocument：创建新文档getDocument：按ID检索文档updateDocument：更新现有文档deleteDocument：按ID删除文档bulkCreateDocuments：一次创建多个文档
索引管理
createIndex：在指定字段上创建新索引createPrimaryIndex：在集合上创建主索引listIndexes：列出bucket中的所有索引dropIndex：删除现有索引
每个工具都支持可选 collection 和 scope 用于定位特定数据容器的参数。
🔒 安全考虑
- 始终对敏感凭据使用环境变量
- 考虑在反向代理后运行服务器以供生产使用
- 根据需要实施适当的访问控制和身份验证
📚 例子
以下是使用MCP服务器与Claude进行交互的一些示例：
- 列出所有桶：
Could you show me all available buckets in the database?- 创建范围和集合：
Create a new scope called "users" and a collection called "profiles" in it- 查询文档：
Find all users who signed up in the last 30 days- 创建文档：
Create a new user document with name "John Doe" and email "john@example.com"🤝 贡献
欢迎投稿！请随时提交拉取请求。
