Pdf2md

Add to Cursor Add to VS Code Add to Claude Add to ChatGPT Add to Codex Add to Gemini

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

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.