PDF Manipulation MCP Server

📚 This project is entirely based on PyMuPDF - a powerful Python library for PDF manipulation. Please check out the official PyMuPDF documentation to learn more about its extensive capabilities!

A study project implementing a Model Context Protocol (MCP) server that provides comprehensive PDF manipulation capabilities using the official MCP FastMCP framework. This project focuses on direct PDF editing and manipulation features for learning and experimentation purposes.

Quick Start: Run directly with uv run pdf-manipulation-mcp-server (like npx for Node.js packages)

Features

• Text Operations: Add, replace, and manipulate text in PDFs
• Image Operations: Add images and extract images from PDFs
• Annotations: Add various types of annotations (text, highlight, underline, etc.)
• Form Fields: Add and fill form fields
• Page Manipulation: Merge, split, rotate, delete, and crop pages
• Auto-Crop: Automatically detect and crop content boundaries
• Page Combination: Combine multiple pages into single pages with various layouts
• Metadata: Get and set PDF metadata

Quick Start

Prerequisites

• Python 3.10+
• pip (comes with Python)

📖 For detailed installation instructions, see INSTALL.md

Installation

Option 1: Run Directly with UV (Like npx)

# Run without installation (fastest)
uv run pdf-manipulation-mcp-server

Option 2: Install from PyPI

# Install the package
pip install pdf-manipulation-mcp-server

# Run the server
pdf-mcp-server

Option 3: Install from GitHub

# Install directly from GitHub
pip install git+https://github.com/yourusername/pdf-manipulation-mcp-server.git

# Run the server
pdf-mcp-server

Option 4: Clone and Install Locally

# Clone the repository
git clone https://github.com/yourusername/pdf-manipulation-mcp-server.git
cd pdf-manipulation-mcp-server

# Install in development mode
pip install -e .

# Run the server
pdf-mcp-server

Option 5: Using UV (Development)

# Clone the repository
git clone https://github.com/yourusername/pdf-manipulation-mcp-server.git
cd pdf-manipulation-mcp-server

# Install dependencies with UV
uv pip install mcp pymupdf

# Test the server
uv run pytest tests/ -v

# Run the server
uv run python server.py

Available Tools (15 Total)

Text Operations

• pdf_add_text - Add text to a PDF at specified position
• pdf_replace_text - Replace text in a PDF document

Image Operations

• pdf_add_image - Add an image to a PDF
• pdf_extract_images - Extract all images from a PDF

Annotations

• pdf_add_annotation - Add annotations to a PDF (text, highlight, underline, strikeout)

Form Fields

• pdf_add_form_field - Add form fields to a PDF (text, checkbox, radio, combobox)
• pdf_fill_form - Fill form fields in a PDF with values

Page Manipulation

• pdf_merge_files - Merge multiple PDF files into one
• pdf_combine_pages_to_single - Combine multiple pages from a PDF into a single page
• pdf_split - Split a PDF into individual pages or page ranges
• pdf_rotate_page - Rotate a page in a PDF (90, 180, 270 degrees)
• pdf_delete_page - Delete a page from a PDF
• pdf_crop_page - Crop a page in a PDF with coordinate support
• pdf_auto_crop_page - Automatically crop pages by detecting content boundaries

Metadata

• pdf_get_info - Get metadata and information about a PDF
• pdf_set_metadata - Set metadata for a PDF

How to Configure with Cursor IDE

Step 1: Install the Server

Follow the installation steps above to

... View full README on GitHub