Document Reader

🚀 mcp-document-reader

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

I use this tool with Windsurf IDE by Codeium, which only supports MCP tools and not resources.

🚀 Quick Start

✨ Features

• Interact with PDF and EPUB documents.
• Compatible with Windsurf IDE by Codeium.

📦 Installation

Prerequisites

• Python 3.11+
• Poetry

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

📚 Documentation

Configure the 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 configuration (replace the output path with the actual path):

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

Development

Setup

# Install dependencies
poetry install

Testing

poetry run pytest

Code Check

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

📄 License

MIT