Skip to main content

A simple doc reader and converter MCP service

Project description

Use Case: Document Reading 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.

Doc Reading and Converter MCP Server

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

If you were running with pip, you would:

python -m venv docEnv
source docEnv/bin/activate
pip install .
python -m doc_reading_mcp

To run the package with uv:

uv run -m doc_reading_mcp

Running the server

Run the server using the inspector:

npx @modelcontextprotocol/inspector uv run -m doc_reading_mcp

This starts the server with the MCP Inspector UI, which is helpful for testing and debugging.

Run in Cursor/Windsurf/Claude using the following configuration:

    "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.

Installing as a package from Github

You can go much faster by using uvx and just running:

uvx git+https://github.com/mffrydman/doc-reading-mcp

to run the service.

Configure your MCP client:

{
    "mcpServers": {
        "doc-reading-mcp": {
            "command": "uvx",
            "args": [
                "git+https://github.com/mffrydman/doc-reading-mcp",
            ]
        }
    }
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

doc_reading_mcp-0.1.0.tar.gz (61.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

doc_reading_mcp-0.1.0-py3-none-any.whl (4.9 kB view details)

Uploaded Python 3

File details

Details for the file doc_reading_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: doc_reading_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 61.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for doc_reading_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 a22001baac2b6353df1067399d9be666b01bb7ada086c24bdf1f6662372920bd
MD5 01eafc1d958e1de0346227ad16cf9840
BLAKE2b-256 e031e5300ef37b1a028504df344c39ee1cd93860a266796ed39c06e127ab747c

See more details on using hashes here.

File details

Details for the file doc_reading_mcp-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for doc_reading_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fb6f22d0b1c87a208a5141e21215e929ef677e9ab0df3557791c730b797570a9
MD5 893415af93861a7a202bd5a22248e6d2
BLAKE2b-256 acd9887829ba79b942cdc5bb3d3b86d5ce5c30690d1f541b2a6368bc276fd62b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page