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 .
Command Line Tool
After installation, you can use the mcp-pdf-forms command to start the server:
# Start the server with one or more directories to scan for PDFs
mcp-pdf-forms examples
You can also add it to Claude Code as an MCP:
claude mcp add pdf-forms mcp-pdf-forms .
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