https://github.com/jbchouinard/mcp-document-reader
MCP tool for LLM interaction with EPUB and PDF files.
https://github.com/jbchouinard/mcp-document-reader
Last synced: 3 months ago
JSON representation
MCP tool for LLM interaction with EPUB and PDF files.
- Host: GitHub
- URL: https://github.com/jbchouinard/mcp-document-reader
- Owner: jbchouinard
- License: mit
- Created: 2025-03-08T21:33:32.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-03-08T21:33:47.000Z (7 months ago)
- Last Synced: 2025-06-17T13:19:42.691Z (4 months ago)
- Language: Python
- Size: 28.3 KB
- Stars: 4
- Watchers: 1
- Forks: 4
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- mcp-index - Document Reader - Interact with PDF and EPUB documents, enabling reading and processing tasks within an IDE. Supports seamless handling of document content directly within the development environment. (File Management)
README
# mcp-document-reader
A rudimentary [MCP server](https://modelcontextprotocol.io/introduction) for interacting with PDF and EPUB documents.
I use this with [Windsurf IDE by Codeium](https://codeium.com/windsurf), which
only supports MCP tools, not resources.
## Installation
### Requirements
- [Python 3.11+](https://www.python.org/downloads/)
- [Poetry](https://python-poetry.org/docs/)
```bash
# 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:
```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": []
}
}
}
```
## Development
### Setup
```bash
# Install dependencies
poetry install
```
### Testing
```bash
poetry run pytest
```
### Linting
```bash
poetry run ruff check --fix .
poetry run ruff format .
```
## License
[MIT](LICENSE)