pdf-modifier-mcp 1.0.0

PDF modification tool with CLI and MCP interfaces for AI agents.

PDF Modifier MCP

A Python tool for modifying text within PDF files while preserving the original layout and font styles. Features dual interfaces: a human-friendly CLI and an MCP server for AI agent integration.

Features

• Text Replacement: Find and replace text while preserving font styles
• Regex Support: Pattern-based replacements for dates, IDs, prices
• Hyperlink Management: Create or neutralize clickable links
• Style Preservation: Matches bold/regular fonts using Base 14 fonts
• Dual Interface: CLI for humans, MCP server for AI agents

Installation

From PyPI

pip install pdf-modifier-mcp

From Source

git clone https://github.com/mlorentedev/pdf-modifier-mcp.git
cd pdf-modifier-mcp
make setup

Quick Start

CLI Usage

# Simple text replacement
pdf-mod modify input.pdf output.pdf -r "old text=new text"

# Multiple replacements
pdf-mod modify input.pdf output.pdf -r "$99.99=$149.99" -r "Draft=Final"

# Regex replacement (dates, IDs, etc.)
pdf-mod modify input.pdf output.pdf -r "Order #\d+=Order #REDACTED" --regex

# Create hyperlinks
pdf-mod modify input.pdf output.pdf -r "Click Here=Visit Site|https://example.com"

# Analyze PDF structure
pdf-mod analyze input.pdf --json

# Inspect fonts for specific terms
pdf-mod inspect input.pdf "Invoice" "Total" "$"

MCP Server (for AI Agents)

pdf-modifier-mcp

Claude Desktop Integration

Add to your Claude Desktop configuration (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "pdf-modifier": {
      "command": "pdf-modifier-mcp"
    }
  }
}

Or run directly from PyPI without installing:

{
  "mcpServers": {
    "pdf-modifier": {
      "command": "uvx",
      "args": ["pdf-modifier-mcp"]
    }
  }
}

Available MCP Tools

Tool	Description
read_pdf_structure	Extract complete PDF structure with text positions and fonts
inspect_pdf_fonts	Search for terms and report their font properties
modify_pdf_content	Find and replace text with style preservation

Architecture

┌─────────────────────────────────────────────────────┐
│                    Entry Points                      │
├──────────────────────┬──────────────────────────────┤
│   CLI (Typer+Rich)   │      MCP (FastMCP)           │
│   pdf-mod command    │   pdf-modifier-mcp server    │
└──────────────────────┴──────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────┐
│                   Core Layer                         │
├─────────────────────────────────────────────────────┤
│  modifier.py   │  analyzer.py  │  models.py         │
│  PDFModifier   │  PDFAnalyzer  │  Pydantic schemas  │
└─────────────────────────────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────┐
│                   PyMuPDF (fitz)                     │
└─────────────────────────────────────────────────────┘

Development

# Setup
make setup

# Run quality checks
make check

# Format code
make format

# Run tests
make test

Contributing

See CONTRIBUTING.md for details.

License

MIT License - see LICENSE for details.