marklogic-mcp

# 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 ```bash pip install mcp-marklogic ``` ## Configuration The server requires the following environment variables: ```bash MARKLOGIC_HOST=localhost MARKLOGIC_PORT=8000 MARKLOGIC_USERNAME=admin MARKLOGIC_PASSWORD=admin ``` ## Usage Once installed and configured, you can start the server: ```bash 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) 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: ```bash pip install -e . ``` ### Running Tests ```bash 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