jbchouinard / mcp-document-reader

MCP tool for LLM interaction with EPUB and PDF files.

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

• Python 3.11+
• Poetry

# 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:

{
  "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:

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

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

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

Development

Setup

# Install dependencies
poetry install

Testing

poetry run pytest

Linting

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

License

MIT