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

Related MCP server: mcp-pdf-reader

Installation

Installing via Smithery

To install PDF Tools for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @danielkennedy1/pdf-tools-mcp --client claude

Manual 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.