pdf2md

基于MCP的高性能PDF转Markdown服务，支持本地文件和URL批量处理，保留文档结构并智能优化输出。

article

README

🚀 MCP-PDF2MD 服务

这是一个基于MCP的高性能PDF转Markdown转换服务，由MinerU API提供支持。它可以实现本地文件和URL链接的批量处理，并输出结构化结果，能高效满足大量PDF文件的转换需求。

🚀 快速开始

git clone https://github.com/FutureUnreal/mcp-pdf2md.git
cd mcp-pdf2md

创建虚拟环境并安装依赖： Linux/macOS：

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

Windows：

uv venv
.venv\Scripts\activate
uv pip install -e .

配置环境变量：在项目根目录下创建一个.env文件，并设置以下环境变量：

MINERU_API_BASE=https://mineru.net/api/v4/extract/task
MINERU_BATCH_API=https://

✨ 主要特性

格式转换：将PDF文件转换为带有结构的Markdown格式。
多源支持：支持同时处理本地PDF文件和网络URL链接。
智能处理：自动选择最佳处理方式。
批处理支持：可批量处理多个文件，高效应对大量PDF文件的处理需求。
MCP集成：与Claude Desktop等大语言模型客户端无缝对接。
结构保留：保持原文档结构，包括标题、段落、列表等内容。
智能排版：输出符合人类阅读习惯的文字顺序，支持单列、多列及复杂版式。
公式转换：自动识别并转换文档中的公式为LaTeX格式。
表格提取：自动识别并转换文档中的表格为结构化格式。
清理优化：删除页眉、页脚、注释、页码等，确保语义连贯。
高质量提取：高质量提取PDF文档中的文字、图片和排版信息。

📦 安装指南

系统要求

软件：Python 3.10+

badge

发布者 / 作者 / 所有者

person

FutureUnrealMCP Server

open_in_new来源仓库

详情同步2026-05-20 03:16:56IDfutureunreal-mcp-pdf2md

data_object

技术配置

server_config

{
  "rating": 2.5,
  "dev_lang": "python",
  "mcp_install": "{\n    \"mcpServers\": {\n        \"pdf2md\": {\n            \"command\": \"uv\",\n            \"args\": [\n                \"--directory\",\n                \"C:\\\\path\\\\to\\\\mcp-pdf2md\",\n                \"run\",\n                \"pdf2md\",\n                \"--output-dir\",\n                \"C:\\\\path\\\\to\\\\output\"\n            ],\n            \"env\": {\n                \"MINERU_API_KEY\": \"your_api_key_here\"\n            }\n        }\n    }\n}\n\n{\n    \"mcpServers\": {\n        \"pdf2md\": {\n            \"command\": \"uv\",\n            \"args\": [\n                \"--directory\",\n                \"/path/to/mcp-pdf2md\",\n                \"run\",\n                \"pdf2md\",\n                \"--output-dir\",\n                \"/path/to/output\"\n            ],\n            \"env\": {\n                \"MINERU_API_KEY\": \"your_api_key_here\"\n            }\n        }\n    }\n}"
}

分类信息

分类

开发工具

标签

PDF转换Markdown生成批量处理智能优化

语言

zh_cn

即贴即用配置

MCP 客户端配置生成器

选择客户端，补齐所需环境变量，再复制根据当前 MCP 公开配置生成的完整文件

terminal

环境变量lock填写内容仅保留在当前浏览器标签页，不会上传或保存

MINERU_API_KEY必填

{
  "mcpServers": {
    "pdf2md": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\path\\to\\mcp-pdf2md",
        "run",
        "pdf2md",
        "--output-dir",
        "C:\\path\\to\\output"
      ],
      "env": {
        "MINERU_API_KEY": "<MINERU_API_KEY>"
      }
    }
  }
}

建议保存到claude_desktop_config.json

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载，用户一般按页面提供的连接方式或授权流程接入，不需要在本地长期启动一个 MCP 进程

打开服务方连接页
完成授权或复制端点
在 MCP 客户端中连接

terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖，把 server_config 复制到 MCP 客户端，并按 env_schema 补齐环境变量、密钥或其它配置

复制 server_config
安装所需依赖
补齐环境变量后重启客户端