ModelsAtlas
Explore
Atlas / MCP servers / futureunreal / Pdf2Md

Pdf2MdCAUTION

mcp/futureunreal/pdf2md
MCP server by futureunreal · Audited 2026-10-08
⚑ Report / re-scanSource ↗

PDF to Markdown conversion tool

Verdict
CAUTION
Grade
B
Trust score
86 /100
Exposed tools
2 2r · 0w · 0d
Transport
—
License
MIT
Stars
34
01

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

[](https://smithery.ai/server/@FutureUnreal/mcp-pdf2md) English | 中文

MCP-PDF2MD Service

An MCP-based high-performance PDF to Markdown conversion service powered by MinerU API, supporting batch processing for local files and URL links with structured output.

Key Features

  • Format Conversion: Convert PDF files to structured Markdown format.
  • Multi-source Support: Process both local PDF files and URL links.
  • Intelligent Processing: Automatically select the best processing method.
  • Batch Processing: Support multi-file batch conversion for efficient handling of large volumes of PDF files.
  • MCP Integration: Seamless integration with LLM clients like Claude Desktop.
  • Structure Preservation: Maintain the original document structure, including headings, paragraphs, lists, etc.
  • Smart Layout: Output text in human-readable order, suitable for single-column, multi-column, and complex layouts.
  • Formula Conversion: Automatically recognize and convert formulas in the document to LaTeX format.
  • Table Extraction: Automatically recognize and convert tables in the document to structured format.
  • Cleanup Optimization: Remove headers, footers, footnotes, page numbers, etc., to ensure semantic coherence.
  • High-Quality Extraction: High-quality extraction of text, images, and layout information from PDF documents.

System Requirements

  • Software: Python 3.10+

Quick Start

  1. Clone the repository and enter the directory:
git clone https://github.com/FutureUnreal/mcp-pdf2md.git
cd mcp-pdf2md
  1. Create a virtual environment and install dependencies:

Linux/macOS:

uv venv
source .venv/bin/activate
uv pip install -e .

Windows:

uv venv
.venv\Scripts\activate
uv pip install -e .
  1. Configure environment variables:

Create a .env file in the project r

Read from source at commit 9a541037b226OBSERVED · 2026-10-08
02

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code
claude mcp add pdf2md --env MINERU_API_KEY=${MINERU_API_KEY} -- uvx pdf2md
claude-desktop
{
  "mcpServers": {
    "pdf2md": {
      "command": "uvx",
      "args": [
        "pdf2md"
      ],
      "env": {
        "MINERU_API_KEY": "${MINERU_API_KEY}"
      }
    }
  }
}
03

Exposed tools (2)

2 read · 0 write · 0 destructive.

ToolRiskDescription
convert_pdf_fileread
convert_pdf_urlread
04

Trust audit

CAUTIONgrade B · trust 86/100 Install with care. The audit found things worth knowing before you trust its output.

LayerWhat it checksResult
L0Provenance & inventoryFAIL
L1Static analysis of the codePASS
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfacePASS
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
declared (2 observation(s))
Network
declared (2 observation(s))
Shell
none-observed
Dependencies
pinned
Secrets in source
found

Findings (2)

HIGHHard-coded secrets · inv.env_committed · CWE-798, CWE-321
.env
.env
Why it matters. a real .env in the package
Fix. ship .env.example with placeholders only
LOWInventory / provenance · inv.hidden_file · CWE-1104
.env
.env
Why it matters. hidden member outside the usual dotfiles
Fix. review its purpose

Gates applied: no_behavioural_pass.

Audited 2026-10-08 · audit v0.4.1 · source sha 9a541037b226full audit observations/trust-audit/mcp-server/futureunreal__pdf2md.json · Report an issue / request a re-scan
05

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-10-089a541037b226CAUTIONB86first audit
06

Questions

What is the Pdf2Md MCP server?

PDF to Markdown conversion tool

What tools does Pdf2Md expose?

2 in total: 2 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.

Is Pdf2Md safe to connect to an agent?

With care. The audit graded it B (86/100) and found 2 things worth knowing before you trust this server, listed below with the exact line each was found on.

What credentials does Pdf2Md need?

It reads MINERU_API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.

How current is this page?

The grade is for one exact copy of the source (9a541037b226), read on 2026-10-08. The repository is watched and re-audited when it changes.

Advertisement