Pdf2md
@FutureUnreal
About Pdf2md
PDF to Markdown conversion tool
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"pdf2md": {
"command": "uv",
"args": [
"--directory",
"C:\\path\\to\\mcp-pdf2md",
"run",
"pdf2md",
"--output-dir",
"C:\\path\\to\\output"
],
"env": {
"MINERU_API_KEY": "your_api_key_here"
}
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Pdf2md?
Pdf2md is an MCP-based high-performance PDF to Markdown conversion service powered by MinerU API. It supports batch processing for local files and URL links with structured output.
How to use Pdf2md?
Clone the repository, create a virtual environment with uv, install dependencies with uv pip install -e ., configure environment variables (MINERU_API_BASE, MINERU_BATCH_API, MINERU_BATCH_RESULTS_API, MINERU_API_KEY) in a .env file, then start the service with uv run pdf2md. For Claude Desktop integration, add the provided JSON configuration specifying the server command, arguments, and API key.
Key features of Pdf2md
- Convert PDF files to structured Markdown format.
- Process local PDF files and URL links.
- Automatically select the best processing method.
- Support for multiple file batch conversion.
- Optional OCR to improve recognition rate.
- Seamless integration with LLM clients like Claude Desktop.
Use cases of Pdf2md
- Convert PDF documents to Markdown for use with LLM clients.
- Batch process multiple PDFs from local files or URLs.
- Extract text from scanned PDFs using optional OCR.
FAQ from Pdf2md
What are the system requirements for Pdf2md?
Python 3.10 or higher is required.
How do I get a MinerU API key?
Register for an account at MinerU’s website (mineru.net), apply for API testing qualification, and once approved, generate a token from the API Management page.
How can I configure the API key for Pdf2md?
Set the API key in the .env file (for development) or in the Claude Desktop configuration under env.MINERU_API_KEY (for regular use). The Claude Desktop config takes precedence.
What sources does Pdf2md support for conversion?
It supports both PDF URLs (via the convert_pdf_url tool) and local PDF files (via the convert_pdf_file tool).
Does Pdf2md support batch conversion?
Yes, the service supports batch processing of multiple PDF files for efficient large-volume conversion.
More Other MCP servers

EverArt
modelcontextprotocolModel Context Protocol Servers
Inbox Zero AI
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Inbox Zero AI MCP
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Nginx UI
0xJackyYet another WebUI for Nginx
Unity MCP ✨
justinpbarnettUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.
Comments