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.

2. 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

Configuration

The server requires the following environment variables:

Usage

Once installed and configured, you can start the server:

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)

2. read-document

   • Read a document from MarkLogic

   • Parameters:

     • uri: Document URI (required)

3. delete-document

   • Delete a document from MarkLogic

   • Parameters:

     • uri: Document URI (required)

4. 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

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