Servidor MCP MarkLogic

Esta es una implementación de servidor de Protocolo de contexto de modelo (MCP) para MarkLogic, que le permite interactuar con una base de datos de MarkLogic a través de herramientas MCP.

2. El servidor proporciona las siguientes operaciones:

Crear documento

• Cree documentos en MarkLogic con colecciones opcionales

• Leer documentos por URI

• Eliminar documentos por URI

• Buscar documentos con cadenas de consulta y filtros de colección opcionales

Instalación

pip install mcp-marklogic

Related MCP server: mcp-graphql

Configuración

El servidor requiere las siguientes variables de entorno:

MARKLOGIC_HOST=localhost
MARKLOGIC_PORT=8000
MARKLOGIC_USERNAME=admin
MARKLOGIC_PASSWORD=admin

Uso

Una vez instalado y configurado, puedes iniciar el servidor:

mcp-marklogic

Herramientas disponibles

1. create-document

   • Crear un nuevo documento en MarkLogic

   • Parámetros:

     • uri : URI del documento (obligatorio)

     • content : Contenido del documento en formato JSON (obligatorio)

     • collections : Lista de colecciones a las que agregar el documento (opcional)

2. read-document

   • Leer un documento de MarkLogic

   • Parámetros:

     • uri : URI del documento (obligatorio)

3. delete-document

   • Eliminar un documento de MarkLogic

   • Parámetros:

     • uri : URI del documento (obligatorio)

4. search-documents

   • Buscar documentos en MarkLogic

   • Parámetros:

     • query : cadena de consulta de búsqueda (obligatoria)

     • collections : Lista de colecciones para buscar (opcional)

Desarrollo

Configuración

1. Clonar el repositorio

2. Crea un entorno virtual y actívalo

3. Instalar dependencias:

   pip install -e .

Ejecución de pruebas

pytest tests/

Configuración de MarkLogic

1. Asegúrese de tener MarkLogic Server instalado y en ejecución

2. Cree una instancia de API REST en el puerto 8000 si aún no está presente

3. Cree un usuario con los permisos adecuados:

   • Vaya a la interfaz de administración (normalmente http://localhost:8001 )

   • Crear el rol python-docs-role con:

     • Roles: rest-extension-user , rest-reader , rest-writer

     • Privilegios: xdbc:eval , xdbc:invoke , xdmp:eval-in

   • Crear usuario python-user con:

     • Contraseña: pyth0n

     • Rol: python-docs-role

Licencia

Instituto Tecnológico de Massachusetts (MIT)