couchdb-mcp-server
by robertoamoreno
A Model Context Protocol server for interacting with CouchDB. It enables AI assistants to manage CouchDB databases and documents through a simple interface.
Last updated: N/A
What is couchdb-mcp-server?
This is a TypeScript-based MCP server that provides tools for managing CouchDB databases and documents, allowing AI assistants to interact with CouchDB.
How to use couchdb-mcp-server?
The server requires a CouchDB connection URL and version configured via environment variables (COUCHDB_URL, COUCHDB_VERSION). Install dependencies with npm install, build with npm run build, and then configure your MCP client (e.g., Claude Desktop) to point to the built index.js file. Use the provided tools to interact with CouchDB databases and documents.
Key features of couchdb-mcp-server
Create, list, and delete CouchDB databases
Create, get, update, and delete documents
Mango query support (indexes and queries) for CouchDB 3.x+
Automatic CouchDB version detection
Robust error handling with appropriate error codes and messages
Use cases of couchdb-mcp-server
Enabling AI assistants to store and retrieve data from CouchDB
Automating database management tasks
Building applications that require a simple interface to CouchDB
Integrating CouchDB with other MCP-compatible systems
FAQ from couchdb-mcp-server
What CouchDB versions are supported?
What CouchDB versions are supported?
All versions are supported for basic database and document operations. CouchDB 3.x+ is required for Mango query support.
How do I configure the CouchDB connection?
How do I configure the CouchDB connection?
Set the COUCHDB_URL environment variable to your CouchDB instance's URL. You can also set COUCHDB_VERSION if needed.
How do I install this server?
How do I install this server?
You can install it manually or via Smithery using the provided command. Then, configure your MCP client to point to the built index.js file.
How do I debug this server?
How do I debug this server?
Use the MCP Inspector by running npm run inspector. This will provide a URL to access debugging tools in your browser.
What kind of errors are handled?
What kind of errors are handled?
The server handles invalid database names, document IDs, database existence issues, connection problems, authentication failures, and invalid document data.