https://github.com/danielkennedy1/pdf-tools-mcp
https://github.com/danielkennedy1/pdf-tools-mcp
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/danielkennedy1/pdf-tools-mcp
- Owner: danielkennedy1
- License: mit
- Created: 2025-04-19T17:25:47.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2025-05-17T13:05:26.000Z (6 months ago)
- Last Synced: 2025-05-17T14:23:01.862Z (6 months ago)
- Language: Python
- Size: 1.12 MB
- Stars: 7
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **danielkennedy1/pdf-tools-mcp 🐍** - PDF download, view & manipulation utilities. `http` `git` `github` (📦 Other)
README
# PDF Tools MCP
[](https://smithery.ai/server/@danielkennedy1/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](https://smithery.ai/server/@danielkennedy1/pdf-tools-mcp):
```bash
npx -y @smithery/cli install @danielkennedy1/pdf-tools-mcp --client claude
```
### Manual Installation
```bash
# 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:
```bash
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
```bash
# Update dependencies
uv pip install -e . --upgrade
# Commit changes (uses conventional commit format)
cz commit
```
## Dependencies
- [MCP Framework](https://github.com/modelcontextprotocol/python-sdk)
- [PyMuPDF](https://github.com/pymupdf/PyMuPDF)
- aiohttp/aiofiles for async operations
- python-magic-bin for file type detection
## License
MIT. See [LICENSE](LICENSE).