drio
Open app

couchdb-mcp-server

Source

Catalog onlyCatalog onlySTDIO

Overview

The couchdb-mcp-server is a Model Context Protocol server designed for interacting with CouchDB, enabling AI assistants to manage CouchDB databases and documents through a simple interface.

To use the couchdb-mcp-server, set up your CouchDB connection URL and version in the environment variables, install the necessary dependencies, and run the server. You can also configure it to work with Claude Desktop by adding the server configuration to the appropriate JSON file.

  • Create, list, and delete CouchDB databases. - Create, update, and retrieve documents in a database. - Support for Mango queries and indexes in CouchDB 3.x+. - Robust error handling for common database operations.
  1. Managing CouchDB databases for AI applications.
  2. Automating document creation and retrieval in CouchDB.
  3. Performing complex queries using Mango query syntax.

Add to your AI client

Use these steps to connect couchdb-mcp-server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "couchdb-mcp-server-robertoamoreno": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-couchdb-mcp-server-robertoamoreno"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "couchdb-mcp-server-robertoamoreno": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-couchdb-mcp-server-robertoamoreno"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "couchdb-mcp-server-robertoamoreno": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-couchdb-mcp-server-robertoamoreno"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "couchdb-mcp-server-robertoamoreno": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-couchdb-mcp-server-robertoamoreno"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "couchdb-mcp-server-robertoamoreno": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-couchdb-mcp-server-robertoamoreno"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "couchdb-mcp-server-robertoamoreno": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-couchdb-mcp-server-robertoamoreno"
      ]
    }
  }
}

FAQ

What versions of CouchDB does this server support?

The server supports all CouchDB versions for basic operations and CouchDB 3.x+ for Mango query features.

How do I configure the server?

You can configure the server by setting the CouchDB connection URL and version in environment variables or by creating a `.env` file in the project root.

Is there any debugging tool available?

Yes, you can use the MCP Inspector for debugging, which provides a URL to access debugging tools in your browser.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1613,"uuid":"232b2841-cea9-4677-b289-fb5ed551d439","name":"couchdb-mcp-server","title":"couchdb-mcp-server","description":"","avatar_url":"https://avatars.githubusercontent.com/u/16195292?v=4","created_at":"2025-02-23T09:47:46.577Z","updated_at":"2025-02-23T09:48:51.703Z","status":"created","author_name":"robertoamoreno","author_avatar_url":"https://avatars.githubusercontent.com/u/16195292?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/robertoamoreno/couchdb-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/67e6d17c9990e87633c1c38b654d657e42aa5ae700461acbedadcf7c4e4c4730/68747470733a2f2f736d6974686572792e61692f62616467652f40726f626572746f616d6f72656e6f2f636f75636864622d6d63702d736572766572","type":null,"metadata":"{\"star\":\"1\",\"license\":\"\",\"language\":\"JavaScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-01 15:50:01\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools
couchdb-mcp-server — MCP Registry