couchdb-mcp

MCP server for Apache CouchDB. Manage databases, documents, and run Mango queries through the Model Context Protocol.

Quick Start

npx -y couchdb-mcp

Set the COUCHDB_URL environment variable to connect to your CouchDB instance:

COUCHDB_URL=http://admin:password@localhost:5984 npx -y couchdb-mcp

Defaults to http://localhost:5984 if not set.

Tools

| Tool | Description | |------|-------------| | get_server_info | Get CouchDB server version and features | | list_databases | List all databases | | create_database | Create a new database | | delete_database | Delete a database | | get_database_info | Get database info (doc count, disk size, etc.) | | get_document | Get a document by ID | | create_document | Create a new document (auto or explicit ID) | | update_document | Update a document (requires _rev) | | delete_document | Delete a document by ID and _rev | | list_documents | List documents with pagination | | mango_query | Run a Mango query with selector, sort, fields | | create_index | Create a Mango index | | list_indexes | List all indexes in a database |

Configuration

Claude Desktop / Cline / Cursor

Add to your MCP config:

{
  "mcpServers": {
    "couchdb": {
      "command": "npx",
      "args": ["-y", "couchdb-mcp"],
      "env": {
        "COUCHDB_URL": "http://admin:password@localhost:5984"
      }
    }
  }
}

Requirements

• Node.js 18+
• A running CouchDB instance (3.x recommended)

License

MIT