AI导哈

PDF合并工具

一个基于MCP协议的PDF合并服务，允许MCP兼容的LLM客户端上传、整理、合并和下载PDF文件。

  • by NikhilBelwate
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 NikhilBelwate/pdf-merger-mcp-server

使用说明

PDF合并MCP服务器

一个MCP（模型上下文协议）服务器，它公开 PDF合并应用程序 作为一组工具，任何兼容MCP的LLM客户端都可以用来上传、排列、合并和下载PDF。

工具

工具 说明
pdf_merger_upload_pdfs 将一个或多个PDF文件从磁盘上传到合并服务
pdf_merger_remove_file 从上传会话中删除文件
pdf_merger_merge 按指定顺序合并上传的PDF
pdf_merger_get_download_url 为合并结果构建一次性下载URL

快速开始

# Install dependencies
npm install

# Build
npm run build

# Run (stdio transport — default)
PDF_MERGER_API_URL=http://localhost:3000 npm start

# Run (HTTP transport for remote access)
TRANSPORT=http PORT=4000 PDF_MERGER_API_URL=http://localhost:3000 npm start

环境变量

变量 默认值 描述
PDF_MERGER_API_URL http://localhost:3000 PDF合并应用程序API的基本URL
TRANSPORT stdio 运输方式： stdio 或 http
PORT 4000 HTTP服务器端口（仅当 TRANSPORT=http)

Claude桌面配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "pdf-merger": {
      "command": "node",
      "args": ["/path/to/pdf-merger-mcp-server/dist/index.js"],
      "env": {
        "PDF_MERGER_API_URL": "https://your-merger-app.vercel.app"
      }
    }
  }
}

典型工作流程

  1. 上传 PDFs → 回报 session_id +文件ID
  2. 移除 不需要的文件（可选）
  3. 合并 按照所需的文件顺序→ 返回一次性下载 token
  4. 下载 使用令牌URL

建筑

LLM Client ──MCP──▶ pdf-merger-mcp-server ──HTTP──▶ PDF Merger App (Express)
                     (stdio or HTTP)                  (Vercel Blob + pdf-lib)

发展

npm run dev    # Auto-reload via tsx watch
npm run build  # Compile TypeScript → dist/
npm run clean  # Remove dist/

相关 MCP