How do I use pdf-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@pdf-mcp Summarize the technical specifications from pages 3 to 5 of datasheet.pdf" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

pdf-mcp

An MCP server for reading, rendering, and searching PDF files. Built with PyMuPDF and PyMuPDF4LLM.

Designed for use with LLMs that need to read datasheets and other PDFs containing diagrams, tables, and technical content.

Tools

Tool	Description
`get_pdf_info`	Get metadata about a PDF (page count, author, title, etc.)
`get_table_of_contents`	Get the outline/bookmarks with page numbers for each section
`get_page_text`	Extract text from a page range in `json` (default), `text`, `markdown`, or `html` format. Optionally exclude headers/footers
`get_page_image`	Render a single page as a PNG image, returned as base64 or written to a temp file. Configurable DPI (default 150)
`search_text`	Case-insensitive text search across the entire PDF, returning page numbers and surrounding context

All requests are stateless and take the PDF filename as a parameter.

Setup

Add the following to your .mcp.json:

{
  "mcpServers": {
    "pdf-mcp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/I-CAN-hack/pdf-mcp.git", "pdf-mcp"]
    }
  }
}

This will automatically install and run the server using uvx.

Development

# Install dependencies
uv sync

# Generate test PDFs
uv run python assets/generate.py

# Run tests
uv run pytest tests/ -v

# Run the server locally
uv run pdf-mcp