mcp-pdf-reader
If you are the rightful owner of mcp-pdf-reader and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A PDF file reading server based on FastMCP, supporting PDF text extraction, OCR recognition, and image extraction via the MCP protocol.
๐ 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
mcp-pdf-server/
โโโ pdf_resources/ # Directory for uploaded and processed PDF files
โโโ txt_server.py # Main server entry point
โโโ README.md # Project documentation
โ๏ธ Installation
Recommended Python version: 3.9+
pip install pymupdf mcp
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:
python txt_server.py
You should see logs like:
Serving on http://127.0.0.1:6231
๐ Web Debugging Interface
Open your browser and visit:
http://127.0.0.1:6231
- 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:
mcp run read_pdf_text --args '{"file_path": "pdf_resources/example.pdf", "start_page": 1, "end_page": 5}'
Perform OCR recognition on page 1:
mcp run read_by_ocr --args '{"file_path": "pdf_resources/example.pdf", "start_page": 1, "end_page": 1, "language": "eng"}'
Extract all images from page 3:
mcp run read_pdf_images --args '{"file_path": "pdf_resources/example.pdf", "page_number": 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.
