pdf全能转换

xjbear/pdf2all

1 Stars 370 次浏览 imbear 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

服务介绍

pdf2all全能转换器 (v1.1.3)

这是一个功能强大的 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

查看源码项目主页