PDF Tools MCP

A comprehensive set of PDF manipulation tools built with the Model Context Protocol (MCP) framework.

Features

Local PDF Operations

• Display: Render PDF pages as images
• Merge: Combine multiple pages into a single long page
• Metadata: Extract document metadata
• Text: Extract text blocks and detailed text information
• Snippets: Create freeform or full-width snippets from PDF pages
• Fuse: Combine pages from multiple documents into a single document

Remote PDF Operations

• Display: Render remote PDF pages as images
• Download: Fetch PDFs from URLs to local storage

Installation

# Clone the repository
git clone https://github.com/yourusername/pdf-tools-mcp.git
cd pdf-tools-mcp

# Install dependencies
uv pip install -e .

Usage

Start the MCP server:

python -m src.main

The server provides PDF manipulation endpoints through the MCP protocol.

Development

• Python 3.12+ required
• Uses the MCP framework for tool registration
• PDF documents are stored with UUID4 filenames for security

# Update dependencies
uv pip install -e . --upgrade

# Commit changes (uses conventional commit format)
cz commit

Dependencies

• MCP Framework
• PyMuPDF
• aiohttp/aiofiles for async operations
• python-magic-bin for file type detection

License

MIT. See LICENSE.