Designed for integration with Windsurf IDE by Codeium, enabling the reading and processing of PDF and EPUB documents within the IDE environment.
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: Windsurf Supabase MCP Server
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 .