queryLABSCO SUMMARY
It covers the shape of the database, not just the documents in it.
Most servers of this kind stop at read and write. This one also creates scopes and collections, and creates or drops indexes including a primary one — so an agent can stand up somewhere to put data before it puts data there.
What it is
A server for Couchbase running on Capella. It connects with a connection string and a bucket you configure, then works over the documents, scopes, collections and indexes in that bucket.
What you get
- Documents: getDocument, createDocument, updateDocument and deleteDocument, plus bulkCreateDocuments for a batch
- Buckets and structure: listBuckets, listScopes, createScope, deleteScope, createCollection and dropCollection
- Indexes: listIndexes, createIndex, createPrimaryIndex and dropIndex
Requirements
A running Couchbase instance on Capella, and Node.js. The connection string, bucket name, username and password go in your client config; npx fetches the package, or you can clone and build it yourself.
Setup effort
One command plus credentials — npx -y @couchbasedatabase/couchbase-mcp, then supply credentials
USE CASES
01
Loading a dataset into a fresh bucket
Create the scope and collection, add a primary index so the data is reachable, then write the documents in one batch.
02
Getting oriented in a cluster you did not build
List the buckets, then the scopes inside one, then the indexes — enough to know what is there before touching anything.
03
Fixing one bad record
Fetch the document by key, correct it and write it back, without a console session or a one-off script.
04
Tidying up after an experiment
Drop the index and the collection you created for a trial, and remove the scope behind them.
16 tools
Listed in project docs. Your client may show a different list.
listBucketscreateScopedeleteScopelistScopescreateCollectiondropCollectioncreateDocumentgetDocumentupdateDocumentdeleteDocumentbulkCreateDocumentscreateIndexcreatePrimaryIndexlistIndexesdropIndexBEFORE YOU INSTALL
What to know first
Tools you get
16 tools named in the project's documentation.
Requires
- npx on PATH
- Node.js 16 or later
- COUCHBASE_PASSWORD in your environment
- COUCHBASE_USERNAME in your environment
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @couchbasedatabase/couchbase-mcpMCP Clients
Claude Desktop — npx
CLAUDE DESKTOP — NPX · JSON
{
"mcpServers": {
"couchbase": {
"command": "npx",
"args": [
"-y",
"@couchbasedatabase/couchbase-mcp"
],
"env": {
"COUCHBASE_URL": "<YOUR_COUCHBASE_URL>",
"COUCHBASE_BUCKET": "<YOUR_COUCHBASE_BUCKET>",
"COUCHBASE_USERNAME": "<YOUR_COUCHBASE_USERNAME>",
"COUCHBASE_PASSWORD": "<YOUR_COUCHBASE_PASSWORD>"
}
}
}
}Claude Desktop — Local build
Clone and build it
This route runs the server from your own build instead of the npx package.
CLAUDE DESKTOP — LOCAL BUILD · TERMINAL
git clone https://github.com/Aniket310101/MCP-Server-Couchbase.git
cd MCP-Server-Couchbase
npm install
npm run buildAdd to claude_desktop_config.json
<YOUR_PATH_TO_MCP_SERVER_COUCHBASE> is the absolute path of the folder you just cloned (the client does not resolve a relative path).
CLAUDE DESKTOP — LOCAL BUILD · JSON
{
"mcpServers": {
"couchbase": {
"command": "node",
"args": [
"<YOUR_PATH_TO_MCP_SERVER_COUCHBASE>/dist/index.js"
],
"env": {
"COUCHBASE_URL": "<YOUR_COUCHBASE_URL>",
"COUCHBASE_BUCKET": "<YOUR_COUCHBASE_BUCKET>",
"COUCHBASE_USERNAME": "<YOUR_COUCHBASE_USERNAME>",
"COUCHBASE_PASSWORD": "<YOUR_COUCHBASE_PASSWORD>"
}
}
}
}
