PDF Forms

🚀 MCP PDF Forms

A PDF form manipulation toolkit built with MCP and PyMuPDF.

🚀 Quick Start

After installation, you can use the package to operate through the MCP interface.

✨ Features

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

📦 Installation

# Install the package from PyPI
pip install mcp_pdf_forms

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

💻 Usage Examples

Command-line Tools

After installation, you can use the mcp-pdf-forms command to start the server:

# Use one or more directories to scan for PDF files
mcp-pdf-forms examples

You can also add it to Claude Code as an MCP:

claude mcp add pdf-forms mcp-pdf-forms .

PDF Discovery Tool

The PDF discovery tool helps you find PDF files in the specified directory.

• Input: The path of the directory to search.
• Output: A list of all PDF files found in the specified directory.
• Use Case: Quickly locate all PDF files in a project or a specified folder.

Form Field Extraction Tool

The form field extraction tool extracts information about all form fields from a PDF document.

• Input: The path of the PDF file.
• Output: Detailed information about each form field, including the field name, type, location, and other attributes.
• Use Case: Analyze the form structure and understand the available fillable fields.

Field Highlighting Visualization Tool

The field highlighting tool generates a new PDF file with all form fields highlighted.

• Input: The path of the PDF file.
• Output: A modified PDF file with form fields highlighted.
• Use Case: Intuitively check the layout and location of form fields in a document.

📚 Documentation

Libraries Used

• MCP - A machine conversation protocol framework.
• PyMuPDF - Python bindings for the high-performance PDF library MuPDF.

📄 License

MIT