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.