Pdf Toolkit MCP

PDF工具包MCP服务器

用于PDF操作的MCP服务器——从Markdown创建、填写表单、合并、拆分、加密、添加二维码。零配置，原生TypeScript。

](https://www.npmjs.com/package/@aryanbv/pdf-toolkit-mcp)  ](https://nodejs.org) 

安装

npx -y @aryanbv/pdf-toolkit-mcp

没有配置文件，没有API密钥，没有Docker。离线工作。

从Markdown创建PDF

最突出的功能是将Markdown转换为专业PDF：

“使用此Markdown创建带有页码的PDF”

# Quarterly Report

## Revenue

Revenue grew **23% year-over-year**, driven by enterprise expansion.

| Region    | Q1 2025  | Q1 2026  | Growth |
|-----------|----------|----------|--------|
| Americas  | $1.2M    | $1.5M    | +25%   |
| EMEA      | $800K    | $960K    | +20%   |
| APAC      | $400K    | $520K    | +30%   |

## Key Wins

1. Signed 12 new enterprise contracts
2. Reduced churn to 3.1%
3. Launched self-serve tier

这将生成一个包含格式化标题、样式表、编号列表、粗体/斜体文本和页码的多页PDF，所有这些都来自一个工具调用。

客户端设置

Claude Desktop

添加到您的Claude桌面配置(claude_desktop_config.json):

{
  "mcpServers": {
    "pdf-toolkit": {
      "command": "npx",
      "args": ["-y", "@aryanbv/pdf-toolkit-mcp"]
    }
  }
}

Claude Code

claude mcp add pdf-toolkit -- npx -y @aryanbv/pdf-toolkit-mcp

Cursor

添加 .cursor/mcp.json （项目）或 ~/.cursor/mcp.json （全球）：

{
  "mcpServers": {
    "pdf-toolkit": {
      "command": "npx",
      "args": ["-y", "@aryanbv/pdf-toolkit-mcp"]
    }
  }
}

VS Code

VS代码使用 "servers"，不 "mcpServers". 从其他客户端复制配置将自动失败。需要启用代理模式的GitHub Copilot扩展。

添加 .vscode/mcp.json:

{
  "servers": {
    "pdf-toolkit": {
      "command": "npx",
      "args": ["-y", "@aryanbv/pdf-toolkit-mcp"]
    }
  }
}

Windsurf

添加 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "pdf-toolkit": {
      "command": "npx",
      "args": ["-y", "@aryanbv/pdf-toolkit-mcp"]
    }
  }
}

工具

按类别组织的16种工具：

模板

从结构化数据生成专业文档：

“为Acme Corp创建发票”

{
  "templateName": "invoice",
  "data": {
    "companyName": "Your Company",
    "clientName": "Acme Corp",
    "invoiceNumber": "INV-001",
    "invoiceDate": "2026-04-01",
    "items": [
      { "description": "Web Development", "quantity": 40, "unitPrice": 150 },
      { "description": "Hosting (Annual)", "quantity": 1, "unitPrice": 299 }
    ],
    "taxRate": 18,
    "paymentTerms": "Net 30"
  },
  "outputPath": "/path/to/invoice.pdf"
}

可用模板： invoice, report, letter.

加密

“使用密码‘secure123’加密report.pdf”

应用RC4 128位加密。为精细的访问控制设置单独的用户（打开）和所有者（编辑）密码。

二维码和条形码

“在第1页添加链接到我们网站的二维码”

支持的类型：二维码、Code128、DataMatrix、EAN-13、PDF417、阿兹特克码。位置和尺寸完全可配置。

用法示例

自然地问：

• “根据此Markdown报告创建PDF”
• “为客户公司开具发票——10小时咨询，150美元/小时”
• “将january.pdf和february.pdf合并为q1合并.pdf”
• “从thesis.pdf的第5-10页中提取文本”
• “在application.pdf中用‘John Doe’填写姓名字段”
• “在草稿.pdf中添加机密水印”
• “使用密码'budget2026'加密financials.pdf”
• “在演示文稿.pdf中添加页码”
• “在封面上嵌入带有我们网址的二维码”
• “在report.pdf中将页面重新排序为3,1,2”

已知限制

• 合并/拆分/重新排序：表单字段不保留。视觉内容传输，但交互式字段丢失。
• 文本提取：返回PDF流顺序，而不是视觉阅读顺序。多列布局可能会交错。
• 提取文本：默认为前10页，以避免超出LLM上下文。请求更长文档的特定页面。
• 图像嵌入：仅支持JPEG和PNG格式。
• 填表：非拉丁字符（阿拉伯语、CJK、天城）需要提供自定义字体文件（.ttf/.otf）。
• 加密：使用RC4 128位，而不是AES。足以进行访问控制，但不是现代强加密。
• Markdown字体：pdfmake仅使用Roboto。Markdown PDF尚不支持自定义字体。

技术栈

双引擎架构，实现最大性能：

• PDFM。 --丰富的文档创建（Markdown、模板、表格、页眉/页脚）
• @pdfme/pdf库 --现有的PDF操作（合并、拆分、旋转、水印、表单、图像、二维码）
• unpdf --文本提取和元数据读取

需求

• Node.js>=18

发展

npm install          # Install dependencies
npm run build        # Compile TypeScript
npm run test         # Run all 51 tests
npm run inspect      # Open MCP Inspector (requires Node >= 22.7.5)

看 CLAUDE.md 了解架构细节和贡献指南。

许可证

麻省理工学院