MCP.so
Sign In

Pdf2md

@FutureUnreal

About Pdf2md

PDF to Markdown conversion tool

Basic information

Category

Other

Transports

stdio

Publisher

FutureUnreal

Submitted by

FutureUnreal

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.

Comments

More Other MCP servers