pdf2all全能转换器 (v1.1.4)

这是一个功能强大的 MCP (Model Context Protocol) 服务器，提供全能的 PDF 转换工具。支持将 PDF 转换为 Word、Excel、PPT 和 JPG 图片。

✨ 功能特性

• PDF 转 Word (docx): 保持排版、表格和图片。
• PDF 转 Excel (xlsx): 智能提取表格，支持 OCR (内置 RapidOCR，无需额外安装软件)。
• PDF 转 PPT (pptx): 将每一页转换为幻灯片。
• PDF 转图片 (jpg): 高清转换每一页。
• 云端存储支持: 自动将转换结果上传到 S3 兼容存储桶（AWS, MinIO, Bitiful 等），并返回下载链接，避免 Base64 传输导致 Token 溢出。

🚀 快速开始

方式 1: 使用 npx 直接运行

npx -y pdf2all-mcp

方式 2: 安装到本地

npm install -g pdf2all-mcp
pdf2all-mcp

⚙️ 配置说明 (重要)

为了使用云端存储功能和确保 Python 环境正常，你需要配置环境变量。

1. 环境变量列表

| 变量名 | 是否必填 | 说明 | 示例 | |--------|----------|------|------| | S3_ENDPOINT | 选填* | S3 兼容服务的 Endpoint URL (开启云存储必填) | https://s3.bitiful.net | | S3_ACCESS_KEY_ID | 选填* | Access Key ID (开启云存储必填) | your_access_key | | S3_SECRET_ACCESS_KEY | 选填* | Secret Access Key (开启云存储必填) | your_secret_key | | S3_BUCKET | 选填* | 存储桶名称 (开启云存储必填) | pdf2all | | S3_REGION | 选填 | 区域 (默认 auto) | auto 或 us-east-1 | | S3_PUBLIC_DOMAIN | 选填 | 自定义下载域名 (用于生成更短的下载链接) | https://cdn.example.com | | PYTHON_PATH | 选填 | 指定 Python 解释器路径 (默认使用系统 python) | D:\env\python\python.exe |

* 说明: 如果不配置 S3 相关变量，服务器将以本地模式运行。

• 本地文件输入: 直接在本地生成文件。
• URL/Base64 输入: 返回文件的 Base64 编码（注意：大文件可能会导致 LLM Token 溢出，建议配置 S3）。

2. 多平台配置指南

Claude Code / Claude Desktop

在 claude_desktop_config.json 中配置：

{
  "mcpServers": {
    "pdf2all": {
      "command": "npx",
      "args": ["-y", "pdf2all-mcp"],
      "env": {
        "S3_ENDPOINT": "https://s3.bitiful.net",
        "S3_ACCESS_KEY_ID": "your_key",
        "S3_SECRET_ACCESS_KEY": "your_secret",
        "S3_BUCKET": "pdf2all",
        "PYTHON_PATH": "python"
      }
    }
  }
}

Cursor

在 Cursor 的 MCP 设置中添加：

• Name: pdf2all
• Type: command
• Command: npx -y pdf2all-mcp
• Environment Variables: 添加上述 S3 和 PYTHON_PATH 变量。

Windsurf

在 Windsurf 的配置文件或 MCP 管理界面中：

{
  "mcpServers": {
    "pdf2all": {
      "command": "npx",
      "args": ["-y", "pdf2all-mcp"],
      "env": {
        "S3_ENDPOINT": "...",
        "S3_ACCESS_KEY_ID": "...",
        "S3_SECRET_ACCESS_KEY": "...",
        "S3_BUCKET": "...",
        "PYTHON_PATH": "python"
      }
    }
  }
}

Antigravity (Gemini)

在 mcp-config.json 中：

{
  "mcpServers": {
    "pdf2all": {
      "command": "node",
      "args": ["/path/to/pdf2all/dist/src/index.js"],
      "env": {
        "S3_ENDPOINT": "...",
        "S3_ACCESS_KEY_ID": "...",
        "S3_SECRET_ACCESS_KEY": "...",
        "S3_BUCKET": "...",
        "PYTHON_PATH": "D:\\env\\python\\python.exe"
      }
    }
  }
}

3. 使用本地配置文件 (备选)

如果你不方便修改客户端配置，也可以在你的用户主目录下创建一个配置文件：

Windows: C:\Users\你的用户名\.pdf2all-mcp\.env macOS/Linux: ~/.pdf2all-mcp/.env

文件内容示例：

S3_ENDPOINT=https://s3.bitiful.net
S3_ACCESS_KEY_ID=xxx
S3_SECRET_ACCESS_KEY=xxx
S3_BUCKET=pdf2all
PYTHON_PATH=D:\env\python\python.exe

4. 云端部署指南 (重要)

如果你在云端环境（如 Railway, Zeabur, 支付宝小程序云等）部署，请注意：

• Python 环境: 大多数 Node.js 云环境不包含 Python。
• 推荐方案: 使用 Docker 部署。本项目已包含 Dockerfile，会自动安装 Node.js 18 + Python 3 + 所有依赖。
• 备选方案 (npx): 本项目包含 postinstall 脚本，在支持 Python 的环境中会自动尝试运行 pip install。如果部署失败，请检查云端是否安装了 Python 3.8+。

Docker 部署示例 (docker-compose.yml):

services:
  pdf2all:
    build: .
    environment:
      - S3_ENDPOINT=...
      - S3_ACCESS_KEY_ID=...
      - S3_SECRET_ACCESS_KEY=...
      - S3_BUCKET=...

🛠️ 依赖要求

• Node.js: >= 18
• Python: >= 3.8
  • 需安装依赖: pip install -r python/requirements.txt
  • 包含: pdf2docx, pdfplumber, rapidocr_onnxruntime 等。
  • OCR 说明: 本项目使用 RapidOCR (基于 ONNX)，无需安装 Tesseract 软件，安装 Python 依赖即可使用。

📝 使用示例

在 MCP 客户端中，你可以这样问：

• "把这个 PDF 转成 Word 文档：[文件路径/URL]"
• "帮我提取这个 PDF 里的表格到 Excel"
• "把这个 PDF 的每一页都转成图片，并打包给我"

📄 许可证

MIT