Lizeur

🚀 Lizeur - PDF Content Extraction MCP Server

Lizeur is a Model Context Protocol (MCP) server that empowers AI assistants to extract and read content from PDF documents using Mistral AI's OCR capabilities. It offers a straightforward interface to convert PDF files into markdown text, which can be easily utilized by AI models.

🚀 Quick Start

Lizeur simplifies the process of extracting content from PDF documents. First, ensure you meet the prerequisites and complete the installation. Then, configure the necessary settings in the mcp.json file. Once set up, AI assistants can use the provided tools to interact with PDF files efficiently.

✨ Features

• PDF OCR Processing: Leverages Mistral AI's latest OCR model to extract text from PDF documents.
• Intelligent Caching: Automatically caches processed documents to avoid redundant processing.
• Markdown Output: Returns clean markdown text for seamless integration with AI workflows.
• FastMCP Integration: Built with FastMCP for optimal performance and user - friendliness.

📦 Installation

Prerequisites

• Python 3.10
• UV package manager
• Mistral AI API key

From pypi

pip install lizeur

Add the following configuration to your mcp.json file:

⚠️ Important Note

Lizeur will be installed in the python3.10 folder. If this folder is not in your system PATH, your IDE may not be able to detect the lizeur binary.

💡 Usage Tip

You can add the full path to the lizeur binary in the command field to ensure your IDE can locate it.

{
  "mcpServers": {
    "lizeur": {
      "command": "lizeur",
      "env": {
        "MISTRAL_API_KEY": "your-mistral-api-key-here",
        "CACHE_PATH": "your cache path"
      }
    }
  }
}

Manual

1. Clone the Repository

git clone https://github.com/SilverBzH/lizeur
cd lizeur

2. Create and Activate Virtual Environment

# Create a virtual environment
uv venv --python 3.10

# Activate the virtual environment
# On macOS/Linux:
source .venv/bin/activate

# On Windows:
# .venv\Scripts\activate

3. Install Dependencies and Build

# Install dependencies
uv sync

# Build the package
uv build

4. Install System - Wide

# Install the package system-wide
uv pip install --system .

This will install the lizeur command globally on your system.

💻 Usage Examples

Available Functions

read_pdf

• Function: read_pdf
• Parameter: absolute_path (string) - The absolute path to the PDF file
• Returns: Complete OCR response including all pages with markdown content, bounding boxes, and other OCR metadata

read_pdf_text

• Function: read_pdf_text
• Parameter: absolute_path (string) - The absolute path to the PDF file
• Returns: Markdown text content from all pages without the full OCR metadata (simpler for agents to process)

Example Usage in AI Assistant

The AI assistant can use the tools as follows:

What the OP command looks like for this specific controller, here is the doc /path/to/document.pdf

The MCP server will:

1. Check if the document is already cached.
2. If not cached, upload the PDF to Mistral AI for OCR processing. This will use your MISTRAL API key and cost money.
3. Extract the text and convert it to markdown.
4. Cache the result for future use.
5. Return the markdown content.

⚠️ Important Note

Use read_pdf_text when you only need the text content, or read_pdf when you need the complete OCR response with metadata. read_pdf can be confusing for some agents if the PDF file is large.

📚 Documentation

Local Development Setup

# Install in development mode
uv pip install -e .

# Run the server directly
python main.py

Project Structure

• main.py - Main server implementation with FastMCP integration
• pyproject.toml - Project configuration and dependencies
• uv.lock - Locked dependency versions

🔧 Technical Details

Dependencies

📄 License

This project is licensed under the MIT License.

📚 Support

For issues and questions, please refer to the project repository or contact the maintainers.