Skip to main content
Glama
EricBoix

PDF MCP Server

by EricBoix
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

PDF MCP Server

An MCP server that exposes PDF files as resources, page by page, over Streamable HTTP.

Setup

Create and activate a virtual environment, then install dependencies:

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Related MCP server: pymupdf4llm-mcp

Launch

fastmcp run server.py --transport http

The MCP endpoint will be available at http://localhost:8000/mcp.

Options

Flag

Default

Description

--host

127.0.0.1

Bind address

--port

8000

Port

--reload

off

Restart on file changes (dev mode)

Example with custom port:

fastmcp run server.py --transport http --port 9000

Resources

Place PDF files in the same directory as server.py. Three resource URIs are exposed:

URI

Returns

pdf://list

List of all PDF filenames in the server directory

pdf://{filename}/info

Page count and metadata for the given PDF

pdf://{filename}/page/{page}

Extracted text of page {page} (1-indexed)

Example

pdf://list
pdf://my_document.pdf/info
pdf://my_document.pdf/page/1

Running and testing

Use fastmcp (on cli) to run the server (and select the transport form)

fastmcp run server.py --transport http

Inspecting can be done with

npx @modelcontextprotocol/inspector

and connect after giving the URL returned by fastmcp command (usually http://127.0.0.1:8000/mcp) with a Streamable http transport type.

References

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • pdf-mcp

    I-CAN-hack
    A
    license
    A
    quality
    C
    maintenance
    An MCP server for reading, rendering, and searching PDF files, specifically optimized for LLMs to extract text, tables, and technical diagrams. It enables metadata retrieval, multi-format text extraction, and page-to-image rendering using PyMuPDF.
    5
    77
    MIT
  • pymupdf4llm-mcp by pymupdf

    pymupdf4llm-mcpofficial

    pymupdf
    A
    license
    Not graded
    quality
    B
    maintenance
    MCP server for exporting PDF to markdown, optimized for LLM consumption.
    1,982 PyPI
    71
    AGPL 3.0

  • pdf-reader-mcp

    iflow-mcp
    F
    license
    Not graded
    quality
    D
    maintenance
    MCP server for extracting text from PDF files, supporting local files and URLs.
    -