Information
MCP-PDF2MD
English | 中文
MCP-PDF2MD 服务
基于 MinerU API 的高性能 PDF 转 Markdown 服务，支持本地文件和 URL 链接的批量处理，并提供结构化输出。
主要功能
格式转换：将 PDF 文件转换为结构化的 Markdown 格式。
多源支持：处理本地 PDF 文件和 URL 链接。
智能处理：自动选择最佳处理方法。
批量处理：支持多文件批量转换，高效处理大量 PDF 文件。
MCP 集成：无缝集成到 Claude Desktop 等 LLM 客户端。
结构保留：保持原始文档结构，包括标题、段落、列表等。
智能布局：以人类可读顺序输出文本，适用于单列、多列和复杂布局。
公式转换：自动识别并转换文档中的公式为 LaTeX 格式。
表格提取：自动识别并转换文档中的表格为结构化格式。
清理优化：移除页眉、页脚、脚注、页码等，确保语义连贯。
高质量提取：从 PDF 文档中高质量提取文本、图像和布局信息。
系统要求
软件：Python 3.10+
快速开始
克隆仓库并进入目录：
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://mineru.net/api/v4/extract/task/batch
MINERU_BATCH_RESULTS_API=https://mineru.net/api/v4/extract-results/batch
MINERU_API_KEY=your_api_key_here
启动服务：
uv run pdf2md
命令行参数
服务器支持以下命令行参数：
Claude Desktop 配置
在 Claude Desktop 中添加以下配置：
Windows:
\{
"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"
\}
\}
\}
\}
Linux/macOS:
\{
"mcpServers": \{
"pdf2md": \{
"command": "uv",
"args": [
"--directory",
"/path/to/mcp-pdf2md",
"run",
"pdf2md",
"--output-dir",
"/path/to/output"
],
"env": \{
"MINERU_API_KEY": "your_api_key_here"
\}
\}
\}
\}
关于 API 密钥配置的说明：
您可以使用两种方式设置 API 密钥：
在项目目录内的 .env 文件中（推荐用于开发）
如上所示，在 Claude Desktop 配置中（推荐用于常规使用）
如果您在两个地方都设置了 API 密钥，则 Claude Desktop 配置中的密钥优先。
MCP 工具
服务器提供了以下 MCP 工具：
convert_pdf_url: 将PDF URL转换为Markdown
convert_pdf_file: 将本地PDF文件转换为Markdown
获取MinerU API密钥
此项目依赖于MinerU API来提取PDF内容。要获取API密钥：
访问MinerU官方网站并注册一个账户
登录后，通过此链接申请API测试资格
一旦您的申请被批准，您可以访问API管理页面
按照提供的说明生成您的API密钥
复制生成的API密钥
使用此字符串作为MINERU_API_KEY的值
请注意，目前访问MinerU API处于测试阶段，需要获得MinerU团队的批准。审批过程可能需要一些时间，请相应地做好计划。
演示
输入PDF
输出Markdown
许可证
MIT许可证 - 详情请参阅LICENSE文件。
致谢
本项目基于MinerU的API。