CouchDB MCP Server

servidor couchdb-mcp

Un servidor de protocolo de contexto de modelo para interactuar con CouchDB

Este es un servidor MCP basado en TypeScript que proporciona herramientas para gestionar bases de datos y documentos de CouchDB. Permite que los asistentes de IA interactúen con CouchDB mediante una interfaz sencilla.

Características

Herramientas

Herramientas básicas (todas las versiones de CouchDB)

• createDatabase - Crea una nueva base de datos CouchDB
  • Toma dbName como parámetro obligatorio
  • Crea la base de datos si no existe
• listDatabases - Lista todas las bases de datos de CouchDB
  • Devuelve una matriz de nombres de bases de datos
• deleteDatabase - Eliminar una base de datos de CouchDB
  • Toma dbName como parámetro obligatorio
  • Elimina la base de datos especificada y todos sus documentos
• createDocument - Crea un nuevo documento o actualiza un documento existente en una base de datos
  • Parámetros requeridos:
    • dbName : Nombre de la base de datos
    • docId : ID del documento
    • data : Datos del documento (objeto JSON)
      • Para actualizaciones, incluya el campo _rev con la revisión actual del documento
  • Devoluciones:
    • Para documentos nuevos: ID del documento y nueva revisión
    • Para actualizaciones: ID del documento y revisión actualizada
  • Detecta automáticamente si la operación es de creación o actualización según la presencia del campo _rev
• getDocument - Obtener un documento de una base de datos
  • Parámetros requeridos:
    • dbName : Nombre de la base de datos
    • docId : ID del documento
  • Devuelve el contenido del documento.

Herramientas de consulta de Mango (solo CouchDB 3.x+)

• createMangoIndex - Crea un nuevo índice de Mango
  • Parámetros requeridos:
    • dbName : Nombre de la base de datos
    • indexName : Nombre del índice
    • fields : Matriz de nombres de campos para indexar
  • Crea un nuevo índice para realizar consultas eficientes
• deleteMangoIndex - Eliminar un índice de Mango
  • Parámetros requeridos:
    • dbName : Nombre de la base de datos
    • designDoc : Nombre del documento de diseño
    • indexName : Nombre del índice
  • Elimina un índice de Mango existente
• listMangoIndexes : enumera todos los índices de Mango en una base de datos
  • Parámetros requeridos:
    • dbName : Nombre de la base de datos
  • Devuelve información sobre todos los índices de la base de datos.
• findDocuments - Consulta documentos mediante la consulta Mango
  • Parámetros requeridos:
    • dbName : Nombre de la base de datos
    • query : objeto de consulta de Mango
  • Realiza una consulta utilizando la sintaxis de consulta Mango de CouchDB

Soporte de versiones

El servidor detecta automáticamente la versión de CouchDB y habilita las funciones según corresponda:

• Todas las versiones: Operaciones básicas de bases de datos y documentos
• CouchDB 3.x+: Compatibilidad con consultas Mango (índices y consultas)

Configuración

El servidor requiere una URL de conexión y una versión de CouchDB. Estas se pueden proporcionar mediante variables de entorno:

Construir el servidor:

Para desarrollo con reconstrucción automática:

Instalación

Instalación mediante herrería

Para instalar couchdb-mcp-server para Claude Desktop automáticamente a través de Smithery :

Para utilizar con Claude Desktop, agregue la configuración del servidor:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
En Windows: %APPDATA%/Claude/claude_desktop_config.json

Prerrequisitos

• Node.js 14 o superior
• Ejecución de una instancia de CouchDB
• Credenciales de CouchDB adecuadas si la autenticación está habilitada

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

Manejo de errores

El servidor incluye un manejo robusto de errores para escenarios comunes:

• Nombres de bases de datos o ID de documentos no válidos
• La base de datos ya existe/no existe
• Problemas de conexión
• Errores de autenticación
• Datos de documento no válidos

Todos los errores se formatean correctamente y se devuelven a través del protocolo MCP con los códigos de error y mensajes apropiados.