Back to the catalog

io.github.penny4nonsense/mcp-pymupdf

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

Open source Open in the app JSON README (API)

About

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

Details

Kind
MCP servers
Topic
Files & documents
Publisher
penny4nonsense
Origin
official
Category
ferramentas
Transport
local
Version
0.1.1
Last push
2026-06-22T16:39:30Z
Repository state
ativo
Language
Python
License
MIT
Added
2026-08-29 04:01:00
Updated
2026-08-29 04:01:00
Origin id
io.github.penny4nonsense/mcp-pymupdf

README

# mcp-pymupdf

<!-- mcp-name: io.github.penny4nonsense/mcp-pymupdf -->

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

## Installation

```bash
pip install mcp-pymupdf
```

## Tools

### `read_pdf`
Extract text from a PDF file or URL.

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

### `get_page`
Extract text from a specific page range.

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

### `get_metadata`
Retrieve PDF metadata without reading full text.

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

## Usage with Claude Desktop

Add to your Claude Desktop config:

```json
{
  "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

More