AI导哈

CouchDB MCP服务器

一个允许从兼容客户端（如Cursor、Claude Desktop）与CouchDB交互的MCP服务器，支持数据库、文档和Mango查询管理。

  • by alecrisostomo
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 alecrisostomo/couchdb-mcp

使用说明

CouchDB MCP Server

Resumen

Servidor MCP que permite interactuar con CouchDB desde clientes compatibles (Cursor, Claude Desktop). Gestiona bases de datos, documentos y consultas Mango.

Guía Rápida

  1. Clonar repositorio

    git clone git@github.com:alecrisostomo/github-webhooks.git
cd couchdb-mcp

    Esta será la ruta que usarás en las configuraciones de Cursor o Claude Desktop.

  2. Instalar dependencias

    npm install

  3. Configurar variables de entorno (crear .env)

    COUCHDB_URL=http://localhost:5984
COUCHDB_USER=admin
COUCHDB_PASSWORD=password

  4. Compilar

    npm run build

  5. Configurar cliente MCP

    Cursor:

    • Settings > Tools & MCP > New MCP server
    • Agregar en mcp.json:
    {
  "mcpServers": {
    "couchdb-mcp-server": {
      "command": "/ruta/al/proyecto/couchdb-mcp/build/main.js",
      "env": {
        "COUCHDB_URL": "http://usuario:password@localhost:5984"
      }
    }
  }
}

    Claude Desktop:

    • Editar ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows)
    • Agregar la misma configuración JSON

  6. Usar

    • El cliente MCP invocará las herramientas automáticamente

Funcionalidades

Bases de Datos

  • createDatabase - Crear base de datos
  • listDatabases - Listar todas las bases de datos
  • deleteDatabase - Eliminar base de datos

Documentos

  • createDocument - Crear/actualizar documento
  • getDocument - Obtener documento

Consultas Mango (CouchDB 3.x+)

  • createMangoIndex - Crear índice Mango
  • deleteMangoIndex - Eliminar índice Mango
  • listMangoIndexes - Listar índices
  • findDocuments - Consultar con query Mango
  • queryDocuments - Consultar con parámetros simplificados

相关 MCP