trackmcp
Back to directory
jbchouinard

mcp-document-reader

View on GitHub

MCP tool for LLM interaction with EPUB and PDF files.

7 stars PythonFile & Data Management Updated Sep 16, 2025

Documentation

mcp-document-reader

A rudimentary MCP server for interacting with PDF and EPUB documents.

I use this with Windsurf IDE by Codeium, which

only supports MCP tools, not resources.

Installation

Requirements

bash
# Clone the repository
git clone https://github.com/jbchouinard/mcp-document-reader.git
cd mcp-document-reader
poetry install

Configure MCP Server

Run with poetry:

json
{
  "mcpServers": {
    "documents": {
      "command": "poetry",
      "args": ["-C", "path/to/mcp-document-reader", "run", "mcp-document-reader"]
    }
  }
}

Alternatively, build and install with pip, then run the script directly:

bash
poetry build
pipx install dist/*.whl
which mcp-document-reader

Then use the following config, with the path output by which:

json
{
  "mcpServers": {
    "documents": {
      "command": "/path/to/mcp-document-reader",
      "args": []
    }
  }
}

Development

Setup

bash
# Install dependencies
poetry install

Testing

bash
poetry run pytest

Linting

bash
poetry run ruff check --fix .
poetry run ruff format .

License

MIT

Frequently asked questions

What is mcp-document-reader?

mcp-document-reader is MCP tool for LLM interaction with EPUB and PDF files.

How do I install mcp-document-reader?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is mcp-document-reader open source?

Yes — it is hosted on GitHub at https://github.com/jbchouinard/mcp-document-reader and has 7 stars.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP