Skip to main content

A simple doc reader and converter MCP service to pdf, docx and markdown

Project description

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

Installation

uv add doc-reading-mcp

Or install directly from the source:

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

Usage

Run as a standalone server

uv run mcp install -m doc_reading_mcp

Or run directly:

uv run -m doc_reading_mcp

Use with MCP Inspector

npx @modelcontextprotocol/inspector uvx run -m doc_reading_mcp

Configure in Claude Desktop, Cursor or Windsurf

Add this to your MCP Configuration:

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

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.

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.1.tar.gz (61.5 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.1-py3-none-any.whl (4.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: doc_reading_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 61.5 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.1.tar.gz
Algorithm Hash digest
SHA256 5fce7baebe9d6ec9652544f0cb98a9c1aaf77e0c221590e2fd3dcdc7171353df
MD5 a4f27d77056626b9a90f475593ec8d17
BLAKE2b-256 552c708ca06c37b7d346da0283d14e4a00ece5ca075f752cd1f8b4d0e0c45c4f

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for doc_reading_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 7478abc78ed34bf1d45b97bb637c196f2b2819bac1aa260006a78398f46a7c51
MD5 f2269ac5f379c84ff57056401951fd50
BLAKE2b-256 58f7e35594cc1d4f8497f7fd455634b210b44a6028721e83b8d99c0fcd347907

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