couchdb-mcp-server

by robertoamoreno

Data/Databases CouchDB Database TypeScript

A Model Context Protocol (MCP) server for interacting with CouchDB databases. It enables AI assistants to manage CouchDB databases and documents through a simple interface.

View on GitHub

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 through a simplified interface.

How to use couchdb-mcp-server?

Install the server using npm or Smithery. Configure the CouchDB connection URL and version via environment variables. Integrate with Claude Desktop by adding the server configuration to the claude_desktop_config.json file.

Key features of couchdb-mcp-server

Create, list, and delete CouchDB databases
Create, update, and retrieve documents
Mango query support (indexes and queries) for CouchDB 3.x+
Automatic CouchDB version detection
Robust error handling with informative error messages

Use cases of couchdb-mcp-server

AI assistant integration with CouchDB
Automated database management
Data retrieval and manipulation via AI
Building AI-powered applications that rely on CouchDB data

FAQ from couchdb-mcp-server

What CouchDB versions are supported?

The server supports all CouchDB versions for basic database and document operations. CouchDB 3.x+ is required for Mango query support.

How do I configure the CouchDB connection?

Set the COUCHDB_URL environment variable to your CouchDB instance's URL (e.g., http://username:password@localhost:5984).

How do I install the server?

You can install it using npm (npm install) or via Smithery (npx -y @smithery/cli install @robertoamoreno/couchdb-mcp-server --client claude).

How do I debug the server?

Use the MCP Inspector (npm run inspector) to access debugging tools in your browser.

What are the prerequisites?

Node.js 14 or higher, a running CouchDB instance, and proper CouchDB credentials if authentication is enabled.