createDatabase
Create a new CouchDB database
LABSCO SUMMARY
The Mango half is the reason to wire this up, and it depends on your CouchDB version.
Basic document CRUD works against any CouchDB, but indexes and Mango queries only appear on 3.x and newer — the server checks the version and enables them accordingly. Credentials travel inside the connection URL, so whatever that user can do to the cluster, the agent can do too.
What it is
A TypeScript server over a single CouchDB connection. It covers the database and document basics on every CouchDB version, and detects the server version on startup to decide whether the Mango query tools are available.
What you get
- Databases created, listed and deleted —
createDatabase,listDatabases,deleteDatabase - Documents written by id, where supplying the current
_revturns the call into an update instead of a create —createDocument - A document read back by database and id —
getDocument - Mango indexes created, listed and removed on CouchDB 3.x and newer —
createMangoIndex,listMangoIndexes,deleteMangoIndex - Documents queried with a Mango query object rather than a fetch-then-filter loop —
findDocuments
Requirements
A reachable CouchDB instance and COUCHDB_URL holding the connection string, credentials included; it defaults to http://localhost:5984 when unset. COUCHDB_VERSION tells the server which feature set to enable. Node.js 14 or higher. Runs from the built build/index.js, or installs into Claude Desktop through Smithery.
Setup effort
One command — npx -y github:robertoamoreno/couchdb-mcp-server
USE CASES
01
Looking through a CouchDB database you did not build
List the databases, then pull individual documents by id to see what the schema actually looks like before writing any query.
02
Answering a question that needs a real query, not a scan
Create an index on the fields you filter by, then run a Mango query against it. On CouchDB older than 3.x these two tools are not registered at all.
03
Seeding a database for a test run
Create the database, then write documents by id. Include _rev when you mean to update an existing one — the tool decides between create and update based on whether that field is present.
5 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
createDocument
Create a new document or update an existing document in a database
deleteDatabase
Delete a CouchDB database
getDocument
Get a document from a database
listDatabases
List all CouchDB databases
BEFORE YOU INSTALL
What to know first
Tools you get
5 tools when we connected.
Requires
- npx on PATH
- Node.js 14 or later
CONTEXT COST
Light Standing cost
Rated by the size of the 5 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"couchdb-mcp-server": {
"command": "npx",
"args": [
"-y",
"github:robertoamoreno/couchdb-mcp-server"
]
}
}
}npx
TERMINAL
npx -y github:robertoamoreno/couchdb-mcp-server
