pdf-tools-mcp

pdf-tools-mcp

9
file_systemsdeveloper_tools

PDF Tools MCP is a set of tools for PDF manipulation, designed using the Model Context Protocol framework. It offers functionalities for rendering, merging, and extracting data from both local and remote PDF documents.

PDF Tools MCP

smithery badge

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

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 .