Which integrations are available for this server?

Allows cloning the repository from [GitHub](/mcp/servers/integrations/github) to set up the MCP PDF Reader server Referenced for installing and running the server through the uv binary path in the VSCode/Cursor integration example Converts PDF content to clean [Markdown](/mcp/servers/integrations/markdown) format for better readability and processing of document text

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

Related MCP server: Markdownify MCP Server - UTF-8 Enhanced

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.

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"] } } }