Document Reader

by jbchouinard

3 stars
Not rated
GitHub

About

Enables interaction with PDF and EPUB documents for reading, analyzing content, and extracting information from document files.

Details

Author
jbchouinard
Repository
jbchouinard/mcp-document-reader
GitHub stars
3
License
MIT License
Categories
Productivity, Developer Tools, Design, Workplace, File Management, AI, Search, Frontend, Knowledge Base, Project Management, Infrastructure

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Document Reader
    Command (node, npx, python, etc.) poetry
    Arguments
    • Argument 1 -C
    • Argument 2 path/to/mcp-document-reader
    • Argument 3 run
    • Argument 4 mcp-document-reader

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository


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": []
}
}
}

poetry install

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

{
    "cwd": "path/to/mcp-document-reader",
    "env": [],
    "args": [
        "-C",
        "path/to/mcp-document-reader",
        "run",
        "mcp-document-reader"
    ],
    "command": "poetry"
}

Macos

{
    "cwd": "path/to/mcp-document-reader",
    "env": [],
    "args": [
        "-C",
        "path/to/mcp-document-reader",
        "run",
        "mcp-document-reader"
    ],
    "command": "poetry"
}

Windows

{
    "cwd": "path/to/mcp-document-reader",
    "env": [],
    "args": [
        "-C",
        "path/to/mcp-document-reader",
        "run",
        "mcp-document-reader"
    ],
    "command": "poetry"
}

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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.