PDF2MD

An MCP (Model Context Protocol) server that converts PDF files to Markdown format using AI sampling capabilities.

Features

• Convert PDF files to Markdown using AI content extraction
• Support for both local file paths and URLs
• Incremental conversion - resume from where you left off
• Configurable output directory
• Built with FastMCP for high performance

Installation

pip install pdf2md-mcp

Usage

As an MCP Server

Start the server:

pdf2md-mcp

The server will expose MCP tools for PDF to Markdown conversion.

Available Tools

convert_pdf_to_markdown

Converts a PDF file to Markdown format using AI sampling.

Parameters:

• file_path (string): Local file path or URL to the PDF file
• output_dir (string, optional): Output directory for the markdown file. Defaults to the same directory as input file (for local files) or current working directory (for URLs)

Returns:

• output_file: Path to the generated markdown file
• summary: Summary of the conversion task
• pages_processed: Number of pages processed

Requirements

• Python 3.10+
• An MCP-compatible client with AI sampling capabilities
• Network access for URL-based PDF files

Development

Setup

git clone https://github.com/shuminghuang/pdf2md-mcp.git
cd pdf2md-mcp
pip install -e ".[dev]"

Running Tests

pytest

Code Formatting

black .
isort .

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.