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-mcpmcp 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
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5fce7baebe9d6ec9652544f0cb98a9c1aaf77e0c221590e2fd3dcdc7171353df
|
|
| MD5 |
a4f27d77056626b9a90f475593ec8d17
|
|
| BLAKE2b-256 |
552c708ca06c37b7d346da0283d14e4a00ece5ca075f752cd1f8b4d0e0c45c4f
|
File details
Details for the file doc_reading_mcp-0.1.1-py3-none-any.whl.
File metadata
- Download URL: doc_reading_mcp-0.1.1-py3-none-any.whl
- Upload date:
- Size: 4.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7478abc78ed34bf1d45b97bb637c196f2b2819bac1aa260006a78398f46a7c51
|
|
| MD5 |
f2269ac5f379c84ff57056401951fd50
|
|
| BLAKE2b-256 |
58f7e35594cc1d4f8497f7fd455634b210b44a6028721e83b8d99c0fcd347907
|