MCP MarkLogic Server

This is a Model Context Protocol (MCP) server implementation for MarkLogic, allowing you to interact with a MarkLogic database through MCP tools.

1. The server provides the following operations:

Create Document

• Create documents in MarkLogic with optional collections
• Read documents by URI
• Delete documents by URI
• Search documents with query strings and optional collection filters

Installation

pip install mcp-marklogic

Configuration

The server requires the following environment variables:

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

Usage

Once installed and configured, you can start the server:

mcp-marklogic

Available Tools

1. create-document

• Create a new document in MarkLogic
• Parameters:
• uri: Document URI (required)
• content: Document content as JSON (required)
• collections: List of collections to add the document to (optional)

1. read-document

• Read a document from MarkLogic
• Parameters:
• uri: Document URI (required)

1. delete-document

• Delete a document from MarkLogic
• Parameters:
• uri: Document URI (required)

1. search-documents

• Search for documents in MarkLogic
• Parameters:
• query: Search query string (required)
• collections: List of collections to search in (optional)

Development

Setup

1. Clone the repository
2. Create a virtual environment and activate it
3. Install dependencies:

   pip install -e .

Running Tests

pytest tests/

MarkLogic Setup

1. Ensure you have MarkLogic Server installed and running
2. Create a REST API instance on port 8000 if not already present
3. Create a user with appropriate permissions:

• Go to Admin Interface (usually http://localhost:8001)
• Create role python-docs-role with:
• Roles: rest-extension-user, rest-reader, rest-writer
• Privileges: xdbc:eval, xdbc:invoke, xdmp:eval-in
• Create user python-user with:
• Password: pyth0n
• Role: python-docs-role

License

MIT