Skip to main content
Glama

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

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

Related MCP server: pdf-mcp

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server that provides powerful RAG (Retrieval-Augmented Generation) capabilities for PDF documents. This server uses ChromaDB for vector storage, sentence-transformers for embeddings, and semantic chunking for intelligent text segmentation.
    MIT