Mdify Mcp — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Mdify Mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
<p align="center"> <h1 align="center">mdify-mcp</h1> <p align="center"> MCP server that gives LLMs the power to convert PDFs to Markdown on the fly </p> </p>
<p align="center"> <a href="https://pypi.org/project/mdify-mcp/"><img src="https://img.shields.io/pypi/v/mdify-mcp?color=blue" alt="PyPI"></a> <a href="https://pypi.org/project/mdify-mcp/"><img src="https://img.shields.io/pypi/pyversions/mdify-mcp" alt="Python"></a> <a href="https://github.com/jupinsker/mdify-mcp/blob/main/LICENSE"><img src="https://img.shields.io/github/license/jupinsker/mdify-mcp" alt="License"></a> <a href="https://github.com/jupinsker/mdify-mcp/actions"><img src="https://img.shields.io/github/actions/workflow/status/jupinsker/mdify-mcp/ci.yml?label=CI" alt="CI"></a> <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-green" alt="MCP"></a> </p>
mdify-mcp is a Model Context Protocol server that wraps mdify — enabling any MCP-compatible client (Claude Desktop, Cursor, VS Code Copilot, etc.) to convert PDF documents to Markdown using a local Ollama vision model.
No cloud APIs. No data leaves your machine. Just point an LLM at a PDF and get structured Markdown back.
| Tool | Description |
|---|---|
convert | Convert a single PDF file to Markdown |
batch_convert | Convert all PDFs in a directory |
read_markdown | Read the contents of a converted Markdown file |
check_ollama | Check if Ollama is installed and the model is available |
pull_ollama_model | Download an Ollama model |
list_pdfs | List all PDF files in a directory |
list_markdowns | List all Markdown files in a directory |
pip install mdify-mcppull_ollama_model tool)Add to your claude_desktop_config.json:
{
"mcpServers": {
"mdify": {
"command": "mdify-mcp",
"env": {
"MDIFY_MODEL": "qwen2.5vl:3b",
"MDIFY_OLLAMA_URL": "http://localhost:11434/v1/chat/completions"
}
}
}
}Add to .cursor/mcp.json in your project:
{
"mcpServers": {
"mdify": {
"command": "mdify-mcp"
}
}
}Add to your VS Code settings (.vscode/mcp.json):
{
"servers": {
"mdify": {
"command": "mdify-mcp",
"env": {
"MDIFY_MODEL": "qwen2.5vl:3b"
}
}
}
}| Variable | Default | Description |
|---|---|---|
MDIFY_MODEL | qwen2.5vl:3b | Ollama model tag |
MDIFY_DPI | 200 | PDF render resolution |
MDIFY_OLLAMA_URL | http://localhost:11434/v1/chat/completions | Ollama API endpoint |
Once configured, you can ask your LLM things like:
"Convert the PDF at /home/user/docs/report.pdf to Markdown"
"Convert all PDFs in /home/user/papers/ and save the Markdown files to /home/user/markdown/"
"Check if Ollama is set up correctly for PDF conversion"
"Pull the qwen2.5vl:7b model for better accuracy"
"List all PDFs in my documents folder"
"Read the Markdown file that was just converted"
┌──────────────┐ MCP (stdio) ┌──────────────┐ HTTP ┌──────────┐
│ LLM Client │ ◄─────────────────► │ mdify-mcp │ ────────────► │ Ollama │
│ (Claude, │ tool calls │ (FastMCP) │ image+prompt │ (local) │
│ Cursor…) │ │ │ │ │
└──────────────┘ └──────┬───────┘ └──────────┘
│
┌──────┴───────┐
│ mdify │
│ (converter) │
└──────────────┘mdify convertergit clone https://github.com/jupinsker/mdify-mcp.git
cd mdify-mcp
pip install -e ".[dev]"
pytestnpx @modelcontextprotocol/inspector mdify-mcpApache License 2.0 — see LICENSE for details.
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.