Apache 2.0
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
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
aiohttp/aiofiles for async operations
python-magic-bin for file type detection
License
MIT. See LICENSE.
This server cannot be installed
Related Resources
Related MCP Servers
- MIT License
- MIT License