MCP PDF Forms

A PDF form manipulation toolkit built with MCP and PyMuPDF.

Features

• Find PDF files across multiple directories
• Extract form field information from PDF files
• Visualize form fields in PDF documents

Installation

# Install package from PyPI
pip install mcp_pdf_forms

# Or install from source
git clone https://github.com/Wildebeest/mcp_pdf_forms.git
cd mcp_pdf_forms
pip install -e .

Server

The server component provides PDF-related tools via MCP's API:

# Start the server with one or more directories to scan for PDFs
uv run -m mcp_pdf_forms.server examples

Or to add to claude-code:

claude mcp add pdf-forms uv run -- --with mcp-pdf-forms -m mcp_pdf_forms.server .

Usage

Once installed, you can use the package to work with PDF forms. The package provides tools through the MCP interface.

PDF Discovery Tool

The PDF Discovery tool helps you find PDF files across specified directories.

• Input: Directory paths to search for PDFs
• Output: List of PDF files found in the specified directories
• Usage: Use this to quickly locate all PDF files in your project or specified folders

Form Field Extraction Tool

The Form Field Extraction tool extracts information about all form fields in a PDF document.

• Input: Path to a PDF file
• Output: Detailed information about each form field including field name, type, position, and other properties
• Usage: Use this to analyze form structure and understand the fields available for filling

Field Highlight Visualization Tool

The Field Highlight tool creates a visual representation of form fields in the PDF.

• Input: Path to a PDF file
• Output: Modified PDF with all form fields highlighted for easy identification
• Usage: Use this to visually inspect the layout and position of form fields in your document

Libraries Used

• MCP - Machine Conversation Protocol framework
• PyMuPDF - Python bindings for MuPDF, a high-performance PDF library

License

MIT