📄 opc-pdf-tools-mcp

MCP Server wrapping PDF CLI tools (Stirling-PDF 87K+ stars) — merge, split, extract text, compress for AI agents

Overview

opc-pdf-tools-mcp wraps battle-tested PDF CLI tools (qpdf, poppler-utils, Ghostscript) to provide AI agents with PDF manipulation capabilities: merging multiple PDFs, splitting pages, extracting text, and compressing files.

Tools

| Tool | Description | |------|-------------| | merge_pdf | Merge multiple PDF files into a single document | | split_pdf | Split a PDF into individual pages or page ranges | | pdf_to_text | Extract text content from PDF with layout preservation | | compress_pdf | Reduce PDF file size with configurable quality levels |

Prerequisites

# macOS
brew install qpdf poppler ghostscript

# Linux (Debian/Ubuntu)
sudo apt install qpdf poppler-utils ghostscript

# Linux (RHEL/Fedora)
sudo dnf install qpdf poppler-utils ghostscript

Installation

npm install opc-pdf-tools-mcp

Usage

As an MCP server

{
  "mcpServers": {
    "pdf-tools": {
      "command": "npx",
      "args": ["opc-pdf-tools-mcp"]
    }
  }
}

Example: merge_pdf

Input:  { "input_files": ["doc1.pdf", "doc2.pdf", "doc3.pdf"] }
Output: Merged 3 PDFs → ./output/merged_1700000000.pdf (2.4MB)

Example: split_pdf

Input:  { "input_file": "report.pdf", "pages": "1-5,7" }
Output: Creates: report_page-1.pdf ... report_page-7.pdf

Example: pdf_to_text

Input:  { "input_file": "paper.pdf", "layout": true, "first_page": 1, "last_page": 3 }
Output: Full text content of pages 1-3 with layout preserved

Example: compress_pdf

Input:  { "input_file": "large.pdf", "quality": "ebook" }
Output: Compressed: 12.3MB → 3.1MB \n Output: ./large_compressed_ebook.pdf

Features

• PDF merging — Combine any number of PDFs in order using qpdf
• Page splitting — Extract individual pages or custom page ranges
• Text extraction — Layout-preserving text extraction via poppler-utils
• Compression — Ghostscript-based compression with 4 quality levels (screen/ebook/printer/prepress)
• File size tracking — Reports original and compressed file sizes
• Batch operations — Handles multi-page documents efficiently

License

MIT