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-mcpmcp 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
- 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
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
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.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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a22001baac2b6353df1067399d9be666b01bb7ada086c24bdf1f6662372920bd
|
|
| MD5 |
01eafc1d958e1de0346227ad16cf9840
|
|
| BLAKE2b-256 |
e031e5300ef37b1a028504df344c39ee1cd93860a266796ed39c06e127ab747c
|
File details
Details for the file doc_reading_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: doc_reading_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 4.9 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 |
fb6f22d0b1c87a208a5141e21215e929ef677e9ab0df3557791c730b797570a9
|
|
| MD5 |
893415af93861a7a202bd5a22248e6d2
|
|
| BLAKE2b-256 |
acd9887829ba79b942cdc5bb3d3b86d5ce5c30690d1f541b2a6368bc276fd62b
|