MCP PDF Reader

A Model Context Protocol (MCP) server that provides tools for reading and processing PDF documents. Built with Docling for document conversion and text extraction.

Features

MCP Server with tools for PDF document processing
Document Text Extraction: Convert PDF content to clean Markdown format
Document Discovery: List and access available PDF files

Tools

The server provides two main tools:

get_document_list: Returns a list of all available PDF files in the data directory
get_document_text: Extracts and returns the full text content of a specified PDF file in Markdown format

Install

Make sure you have uv installed.

Clone the repository:

git clone git@github.com:mlexpertio/mcp-pdf-reader.git
cd mcp-pdf-reader

Install Python:

uv python install 3.12.10

Create and activate a virtual environment:

uv venv
source .venv/bin/activate

Install dependencies:

uv sync

Usage

Add PDF Documents

Place your PDF files in the data/ directory. The server will automatically detect and make them available through the tools.

Run MCP Server

Start the MCP server:

python server.py

The server runs using stdio transport and can be integrated with any MCP-compatible client.

Development and Testing

Use the MCP inspector to test the server:

mcp dev server.py

This will open a web interface where you can test the available tools and inspect their responses.

Use in VSCode/Cursor

You can use the MCP integration in your editor. Tools & Integrations -> New MCP Server and edit the mcp.json file to include the following:

{
  "mcpServers": {
    "pdf-reader": {
      "command": "/opt/homebrew/bin/uv", // path to your uv binary
      "args": ["run", "--directory", "PATH_TO_YOUR_PROJECT", "server.py"]
    }
  }
}

License

See LICENSE file for details.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

A server that provides tools for reading and processing PDF documents, allowing users to list available PDFs and extract their content in Markdown format.

Related MCP Servers

markdown2pdf-mcp
2b3pro
A
security
F
license
A
quality
An MCP server for converting Markdown documents to PDF files.
Last updated -
1
10
10
JavaScript
Markdownify MCP Server - UTF-8 Enhanced
JDJR2024
A
security
A
license
A
quality
A document conversion server that transforms various file formats (PDFs, documents, images, audio, web content) to Markdown with improved multilingual and UTF-8 support.
Last updated -
10
0
9
TypeScript
MIT License
MCP Docling Server
zanetworker
-
security
A
license
-
quality
A 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 -
15
Python
MIT License
Textin MCP Serverofficial
intsig-textin
A
security
A
license
A
quality
A server that enables OCR capabilities to recognize text from images, PDFs, and Word documents, convert them to Markdown, and extract key information.
Last updated -
3
19
18
JavaScript
MIT License

View all related MCP servers

MCP PDF Reader

MCP PDF Reader

Features

Tools

Install

Usage

Add PDF Documents

Run MCP Server

Development and Testing

Use in VSCode/Cursor

License

Related MCP Servers

markdown2pdf-mcp

Markdownify MCP Server - UTF-8 Enhanced

MCP Docling Server

Textin MCP Serverofficial

New MCP Servers

MCP directory API