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
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
pdf-tools-mcp
Related MCP Servers
- MIT License
- MIT License
- MIT License