About Pdf Reader
Pdf Reader is an MCP server published by DeepSeekMine in the Content category: mCP server: Pdf Reader.
The repository has 36 stars and 6 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/DeepSeekMine/mcp-pdf-readerThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (3)
read_by_ocrRecognizes text via OCR
Parameters not published.
read_pdf_imagesExtracts images from a PDF page
Parameters not published.
read_pdf_textExtracts normal text from PDF pages
Parameters not published.
Ask AI
Ask AI about Pdf Reader
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 4 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- !Dependencies pinnedNo lockfile. Installs can pull different code over time.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
📄 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.
README fetched from the repository 4 days ago. The original is authoritative.