Skip to main content
Glama
Sign In
PDF MCP Server

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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

    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
      82
      MIT
    • pymupdf4llm-mcp

      pymupdf4llm-mcpofficial

      pymupdf
      A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for exporting PDF to markdown, optimized for LLM consumption.
      698 PyPI
      73
      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.
      -