Metadata-Version: 2.4
Name: doc-reading-mcp
Version: 0.1.1
Summary: A simple doc reader and converter MCP service to pdf, docx and markdown
Author-email: MatiasFrydman <78177534+mffrydman@users.noreply.github.com>
Requires-Python: >=3.13
Requires-Dist: build>=1.2.2.post1
Requires-Dist: marker-pdf==1.6.2
Requires-Dist: mcp[cli]>=1.6.0
Requires-Dist: pypandoc>=1.15
Requires-Dist: transformers==4.50.3
Requires-Dist: twine>=6.1.0
Description-Content-Type: text/markdown

# Document Reading and Converter Tool

The goal is to have a tool that can read and edit files, using Cursor or Claude Desktop.

The `filesystem` MCP already allows reading, writing and editing documents, but is limited in that it cannot:

- Read pdfs or docx files
- Reads the full document, which can cause context overflow

To address these issues, we create:

- A fresh `doc-reading-mcp` mcp service allowing for document conversions between pdf, docx and markdown.

## Features

- PDF to Markdown conversion using marker-pdf
- DOCX to Markdown conversion using pandoc
- Markdown to DOCX conversion using pandoc
- Markdown to PDF conversion using pandoc

## Prerequisites

- Python 3.10 or higher
- [pandoc] (https://pandoc.org/installing.html) installed on your system
- [uv] (https://docs.astral.sh/uv/) for Python package management 

# Installation

```bash
uv add doc-reading-mcp
```

Or install directly from the source:

```bash
uv add git+https://github.com/mffrydman/doc-reading-mcp.git
```

# Usage

## Run as a standalone server

```bash
uv run mcp install -m doc_reading_mcp
```

Or run directly:

```bash
uv run -m doc_reading_mcp
```

## Use with MCP Inspector

```bash
npx @modelcontextprotocol/inspector uvx run -m doc_reading_mcp
```

## Configure in Claude Desktop, Cursor or Windsurf

Add this to your MCP Configuration:

```json
{
    "mcpServers": {
        "doc-reading-mcp": {
            "command": "uvx",
            "args": [
                "doc-reading-mcp",
            ]
        }
    }
}
```

Run in Cursor/Windsurf/Claude using the following configuration:
```json
    "doc-reading-mcp": {
        "command": "uv",
        "args": [
            "--directory",
            "/absolute/path/to/mffrydman/doc-reading-mcp",
            "run",
            "-m",
            "doc_reading_mcp"
        ]
    }
```

Replace
- `/absolute/path/to/` with the actual path on your system.