MinerU Open MCP vs Markdownify MCP
A side-by-side look at the MinerU Open MCP and Markdownify MCP MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.
Verdict: choose MinerU Open MCP for search & data extraction work as a local process; choose Markdownify MCP for search & data extraction. You can also run both side by side in one mcpServers block.
Which MCP server should you choose?
Choose MinerU Open MCP when
- You need dedicated capabilities in the Search & Data Extraction domain.
- You prefer a local stdio subprocess transport.
- You want tools like
parse_documents, get_ocr_languages.
Choose Markdownify MCP when
- You need dedicated capabilities in the Search & Data Extraction domain.
- Its auth model fits you: No auth required.
- You have the keys it needs:
MARKITDOWN_PATH, REPOMIX_PATH, MD_ALLOWED_PATHS, MD_SHARE_DIR. - You want tools like
youtube-to-markdown, pdf-to-markdown, bing-search-to-markdown.
Feature & specification comparison
Rows where the two servers differ are marked.
| Spec | ||
|---|---|---|
| Category | Search & Data Extraction | Search & Data Extraction |
| Quality signal | 60/100 · Good | 56/100 · Good |
| Install command | Confirmed | Not confirmed yet |
| Transport | Local subprocess (stdio) | — |
| Auth | Not declared | No auth required |
| Pricing | Not declared | Free |
| Required env vars | None listed | MARKITDOWN_PATHREPOMIX_PATHMD_ALLOWED_PATHSMD_SHARE_DIR |
| Verified owner | Community listing | Community listing |
| GitHub stars | 229 | 2,996 |
| Directory activity | 3 views 0 installs 0 upvotes | 4 views 0 installs 0 upvotes |
| Tools | 2 | 10 |
| Full listing | View MinerU Open MCP | View Markdownify MCP |
Tools & capabilities
MinerU Open MCP tools 2
parse_documentsConvert PDF, Office (DOCX, PPTX), spreadsheets (XLSX in Flash mode), images, and http(s) URLs to Markdown using the MinerU cloud API (content is uploaded to mineru.net; do not use for data that must stay on-device). Does not modify source files; may write Markdown under output_dir when saving results. Auth: without MINERU_API_TOKEN, Flash mode applies (Markdown-only, about 20 pages and 10 MB per file; service rate limits). With MINERU_API_TOKEN, higher limits and optional formats per plan. Use for extraction and conversion. Use get_ocr_languages only to list OCR language codes, not to parse files. Not for fully offline parsing. Parameters: file_sources is paths/URLs or objects with source and pages for PDF ranges; language is an OCR code (default ch); enable_ocr defaults to auto (null); set model to html only if every source is a web page URL.get_ocr_languagesReturn supported MinerU OCR and script language codes (e.g. ch, en, japan, latin). Read-only; no uploads. Use before setting the language argument on parse_documents for scanned or multilingual documents. Do not use for file conversion; call parse_documents instead.
Markdownify MCP tools 10
youtube-to-markdownConvert YouTube videos to Markdownpdf-to-markdownConvert PDF files to Markdownbing-search-to-markdownConvert Bing search results to Markdownwebpage-to-markdownConvert web pages to Markdownimage-to-markdownConvert images to Markdown with metadataaudio-to-markdownConvert audio files to Markdown with transcriptiondocx-to-markdownConvert DOCX files to Markdownxlsx-to-markdownConvert XLSX files to Markdownpptx-to-markdownConvert PPTX files to Markdownget-markdown-fileRetrieve an existing Markdown file. File extension must end with: *.md, *.markdown.
Ready-to-paste client configs
Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.
MinerU Open MCP
{
"mcpServers": {
"mineru-open-mcp": {
"command": "uvx",
"args": [
"mineru-open-mcp"
]
}
}
}
Markdownify MCP
No confirmed install command for Markdownify MCP yet — follow the setup steps linked from its listing page rather than a guessed package name.
Frequently asked questions
MinerU Open MCP is categorized under Search & Data Extraction and uses a local stdio subprocess. Markdownify MCP belongs to Search & Data Extraction and uses an install path we have not confirmed yet. Pick MinerU Open MCP for search & data extraction work and Markdownify MCP for search & data extraction.
Copy the mcpServers block from the config section on this page into your client's config (for example claude_desktop_config.json or ~/.cursor/mcp.json), then fully restart the client. Markdownify MCP has no confirmed install command yet — follow its own setup instructions.
MinerU Open MCP has no declared pricing — check the project's own site. Markdownify MCP is listed as free. Auth: no auth required. If a server needs environment variables such as API keys, define them under the env key in your client's MCP config.
Yes. MCP clients support multiple servers: add mineru-open-mcp and zcaceres-markdownify-mcp as separate keys in the same mcpServers object, and your assistant will call tools from either one.
On AllMCPs, MinerU Open MCP has a quality signal of 60/100 (Good) with 3 views, 0 installs and 229 GitHub stars. Markdownify MCP has 56/100 (Good) with 4 views, 0 installs and 2,996 GitHub stars.