Pdf2md MCP Server

@FutureUnreal

Repository

Basic information

About Pdf2md MCP Server

PDF to Markdown conversion tool

#pdf2md#pdf-converter #markdown-converter

Pdf2md MCP Server 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"
      }
    }
  }
}

Pdf2md MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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.

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.

Comments

More Other MCP servers

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This 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,

16.7K

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K