Connects agents to Couchbase Capella and self-managed clusters for document operations and SQL++ queries.
接入配置
选择客户端,复制配置,再按项目文档补齐环境变量。
claude mcp add couchbase --env CB_PASSWORD='<CB_PASSWORD>' --env CB_CONNECTION_STRING='<CB_CONNECTION_STRING>' --env CB_USERNAME='<CB_USERNAME>' --env CB_BUCKET_NAME='<CB_BUCKET_NAME>' -- uvx couchbase-mcp-server~/.codex/config.toml
[mcp_servers.couchbase]
command = "uvx"
args = ["couchbase-mcp-server"]
env = { CB_PASSWORD = "<CB_PASSWORD>", CB_CONNECTION_STRING = "<CB_CONNECTION_STRING>", CB_USERNAME = "<CB_USERNAME>", CB_BUCKET_NAME = "<CB_BUCKET_NAME>" }
# codex mcp add couchbase --env CB_PASSWORD='<CB_PASSWORD>' --env CB_CONNECTION_STRING='<CB_CONNECTION_STRING>' --env CB_USERNAME='<CB_USERNAME>' --env CB_BUCKET_NAME='<CB_BUCKET_NAME>' -- uvx couchbase-mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"couchbase": {
"command": "uvx",
"args": [
"couchbase-mcp-server"
],
"env": {
"CB_PASSWORD": "<CB_PASSWORD>",
"CB_CONNECTION_STRING": "<CB_CONNECTION_STRING>",
"CB_USERNAME": "<CB_USERNAME>",
"CB_BUCKET_NAME": "<CB_BUCKET_NAME>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"couchbase": {
"type": "stdio",
"command": "uvx",
"args": [
"couchbase-mcp-server"
],
"env": {
"CB_PASSWORD": "<CB_PASSWORD>",
"CB_CONNECTION_STRING": "<CB_CONNECTION_STRING>",
"CB_USERNAME": "<CB_USERNAME>",
"CB_BUCKET_NAME": "<CB_BUCKET_NAME>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"couchbase": {
"command": "uvx",
"args": [
"couchbase-mcp-server"
],
"env": {
"CB_PASSWORD": "<CB_PASSWORD>",
"CB_CONNECTION_STRING": "<CB_CONNECTION_STRING>",
"CB_USERNAME": "<CB_USERNAME>",
"CB_BUCKET_NAME": "<CB_BUCKET_NAME>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"couchbase": {
"command": "uvx",
"args": [
"couchbase-mcp-server"
],
"env": {
"CB_PASSWORD": "<CB_PASSWORD>",
"CB_CONNECTION_STRING": "<CB_CONNECTION_STRING>",
"CB_USERNAME": "<CB_USERNAME>",
"CB_BUCKET_NAME": "<CB_BUCKET_NAME>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"couchbase": {
"command": "uvx",
"args": [
"couchbase-mcp-server"
],
"env": {
"CB_PASSWORD": "<CB_PASSWORD>",
"CB_CONNECTION_STRING": "<CB_CONNECTION_STRING>",
"CB_USERNAME": "<CB_USERNAME>",
"CB_BUCKET_NAME": "<CB_BUCKET_NAME>"
}
}
}
}需要的环境变量
CB_PASSWORDCB_CONNECTION_STRINGCB_USERNAMECB_BUCKET_NAME
把占位值换成你自己的密钥;不要把密钥提交到代码仓库。