Pdf2md
@FutureUnreal
About Pdf2md
PDF to Markdown conversion tool
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.
Frequently asked questions
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.
Basic information
More Other MCP servers
Awesome Mlops
visengerA curated list of references for MLOps
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
EverArt
modelcontextprotocolModel Context Protocol Servers
🚀 Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,
Glasswarp
GlasswarpSee and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.
Comments