Skip to main content

MCP server for reading PDFs using PyMuPDF. Supports local files and URLs.

Project description

mcp-pymupdf

An MCP server for reading PDFs using PyMuPDF. Supports local files and URLs.

Installation

pip install mcp-pymupdf

Tools

read_pdf

Extract text from a PDF file or URL.

{
  "source": "/path/to/file.pdf",
  "max_pages": 50,
  "max_bytes": 200000
}

get_page

Extract text from a specific page range.

{
  "source": "https://example.com/paper.pdf",
  "start_page": 3,
  "end_page": 8
}

get_metadata

Retrieve PDF metadata without reading full text.

{
  "source": "/path/to/file.pdf"
}

Usage with Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "pdf": {
      "command": "mcp-pymupdf"
    }
  }
}

Notes

  • Scanned or image-based PDFs cannot be read without OCR
  • Mathematical notation may render as plain text approximations
  • URLs are downloaded to a temp file and deleted after reading

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_pymupdf-0.1.1.tar.gz (2.6 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_pymupdf-0.1.1-py3-none-any.whl (5.6 kB view details)

Uploaded Python 3

File details

Details for the file mcp_pymupdf-0.1.1.tar.gz.

File metadata

  • Download URL: mcp_pymupdf-0.1.1.tar.gz
  • Upload date:
  • Size: 2.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.13

File hashes

Hashes for mcp_pymupdf-0.1.1.tar.gz
Algorithm Hash digest
SHA256 5e3c0128439f8cbd08840c88d984c32042ce6d156c7cf525275c6173bc66ce5d
MD5 5c93ac9a7dd0358b7b7e6426fc06803e
BLAKE2b-256 e76365ba1d174d0e424df3e065d1e467b7a6319d5c85eecd30743dc1041a6724

See more details on using hashes here.

File details

Details for the file mcp_pymupdf-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: mcp_pymupdf-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 5.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.13

File hashes

Hashes for mcp_pymupdf-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 854cfd4043190552ed4628e3bda32430d7d55d1ece36ec795a2c764e4e81e9ee
MD5 b7c80b624ec3d2129489881bf1a2f229
BLAKE2b-256 cfeffd01c359fabd3f057ac46fb5f87761c72ee023e68407d2933f48e39ae265

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page