A
securityF
licenseA
qualityA Model Context Protocol server that converts PDF documents into PNG images through a simple MCP tool call.
Last updated -
1
5
Python
Enables reading and processing PDF files with tools for text extraction, OCR recognition, and image extraction from PDF documents.
Based on FastMCP framework which is hosted on GitHub, allowing users to leverage the MCP protocol implementation for PDF processing.
Requires Python 3.9+ environment to run the server, utilizing Python libraries like PyMuPDF for PDF processing functionality.
📄 MCP PDF Server
A PDF file reading server based on FastMCP.
Supports PDF text extraction, OCR recognition, and image extraction via the MCP protocol, with a built-in web debugger for easy testing.
🚀 Features
- read_pdf_text
Extracts normal text from a PDF (page by page). - read_by_ocr
Uses OCR to recognize text from scanned or image-based PDFs. - read_pdf_images
Extracts all images from a specified PDF page (Base64 encoded output).
📂 Project Structure
⚙️ Installation
Recommended Python version: 3.9+
Note: To use OCR features, you may need a MuPDF build with OCR support or external OCR libraries.
🔦 Start the Server
Run the following command:
You should see logs like:
🌐 Web Debugging Interface
Open your browser and visit:
- Select a tool from the left panel
- Fill in parameters on the right panel
- Click "Run" to test the tool
No coding required — easily debug and test via the web UI.
🛠️ API Tool List
| Tool | Description | Input Parameters | Returns |
|---|---|---|---|
read_pdf_text | Extracts normal text from PDF pages | file_path, start_page, end_page | List of page texts |
read_by_ocr | Recognizes text via OCR | file_path, start_page, end_page, language, dpi | OCR extracted text |
read_pdf_images | Extracts images from a PDF page | file_path, page_number | List of images (Base64 encoded) |
📝 Example Usage
Extract text from pages 1 to 5:
Perform OCR recognition on page 1:
Extract all images from page 3:
📢 Notes
- Files must be placed inside the
pdf_resources/directory, or an absolute path must be provided. - OCR functionality requires appropriate OCR support in the environment.
- When processing large files, adjust memory and timeout settings as needed.
📜 License
This project is licensed under the MIT License.
For commercial use, please credit the original source.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
A PDF processing server that extracts text via normal parsing or OCR, and retrieves images from PDF files through the MCP protocol with a built-in web debugger.
Related MCP Servers
- -securityAlicense-qualityA server that provides document processing capabilities using the Model Context Protocol, allowing conversion of documents to markdown, extraction of tables, and processing of document images.Last updated -13PythonMIT License
- AsecurityFlicenseAqualityAn MCP server that provides a tool to extract text content from local PDF files, supporting both standard PDF reading and OCR capabilities with optional page selection.Last updated -117Python
Textin MCP Serverofficial
AsecurityAlicenseAqualityA server that enables OCR capabilities to recognize text from images, PDFs, and Word documents, convert them to Markdown, and extract key information.Last updated -31918JavaScriptMIT License