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"
}
}
}
}典型工作流程
- 上传 PDFs → 回报
session_id+文件ID - 移除 不需要的文件（可选）
- 合并 按照所需的文件顺序→ 返回一次性下载
token - 下载 使用令牌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/