PDF2MD MCP Server

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

Related MCP server: Awels PDF Processing Server

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.