PDF To Markdown Converter

🚀 MCP-PDF2MD Service

A high-performance PDF to Markdown conversion service based on MCP, powered by MinerU API. It supports batch processing of local files and URL links and outputs structured content.

English | Chinese

✨ Features

• Format Conversion: Convert PDF files to structured Markdown format.
• Multi-source Support: Process both local PDF files and web links simultaneously.
• Intelligent Processing: Automatically select the best processing method.
• Batch Processing: Support batch conversion of multiple files for efficient handling of large numbers of PDF files.
• MCP Integration: Seamlessly integrate with LLM clients such as Claude Desktop.
• Structure Preservation: Maintain the original document structure, including headings, paragraphs, lists, etc.
• Intelligent Typography: Output text that conforms to human reading habits, suitable for single-column, multi-column, and complex layouts.
• Formula Conversion: Automatically recognize and convert formulas in the document to LaTeX format.
• Table Extraction: Automatically recognize and convert tables in the document to a structured format.
• Cleanup and Optimization: Remove headers, footers, annotations, page numbers, etc., to ensure semantic coherence.
• High-quality Extraction: Extract text, images, and layout information with high quality.

📦 System Requirements

• Software: Python 3.10+

🚀 Quick Start

1. Clone the repository and enter the directory:

   git clone https://github.com/FutureUnreal/mcp-pdf2md.git
   cd mcp-pdf2md
   

2. Create a virtual environment and install dependencies:

   Linux/macOS:

   uv venv
   source .venv/bin/activate
   uv pip install -e .
   

   Windows:

   uv venv
   .venv\Scripts\activate
   uv pip install -e .
   

3. Configure environment variables:

   Create a .env file in the project root directory and set the following environment variables:

   MINERU_API_BASE=https://mineru.net/api/v4/extract/task
   MINERU_BATCH_API=https://