procleaning-mcp

Python MCP Server for PDF OCR batch processing.

Features

Batch OCR - Process multiple PDF files and save results as Markdown

Tool

`batch_ocr_pdf`

Batch process all PDF files in a directory using the OCR API.

Parameters:

input_dir: Directory containing PDF files
output_dir: Directory to save Markdown results
api_key: OCR API key (optional, reads from OCR_API_KEY env var)
base_url: OCR API base URL (default: https://agent.imqimacau.com)

Returns: JSON with processing results (success/fail counts per file)

Setup

cd procleaning-mcp
uv sync
uv run python -m procleaning_mcp.server

Usage in Hermes

Add to ~/.hermes/config.yaml:

mcp_servers:
  procleaning:
    command: "uv"
    args: ["run", "--project", "/home/tony/procleaning-mcp", "python", "-m", "procleaning_mcp.server"]
    timeout: 300

Then use mcp_procleaning_batch_ocr_pdf in any Hermes conversation.