LightPDF Agent MCP Server

LightPDF Agent MCP Server 是一个基于 MCP (Model Context Protocol) 的文档格式转换工具，支持多种文档格式之间的相互转换以及PDF的各种处理功能。该工具需要在支持 MCP 功能的软件（如 Cursor, Claude等）中配置使用。

工具列表

格式转换 (convert_document)
- 支持多种文档格式的相互转换
- PDF可转换为：DOCX/XLSX/PPTX/图片(长图)/HTML/TXT
- 其他格式可转换为PDF：DOCX/XLSX/PPTX/图片/CAD/CAJ/OFD
- 输入: files 要转换的文件列表, format 目标格式
去除水印 (remove_watermark)
- 自动识别并去除PDF文档中的水印
- 输入: files 要处理的PDF文件列表
添加水印 (add_watermark)
- 在PDF文档上添加自定义文本水印
- 输入: files 文件列表, text 水印文本, position 位置(center), opacity 透明度(1.0), range 页面范围, layout 布局(on), font_family 字体, font_size 字号, font_color 字体颜色
添加页码 (add_page_numbers)
- 在PDF文档的指定位置添加页码
- 输入: files 文件列表, start_num 起始页码(1), position 页码位置(5), margin 边距(30)
- 位置说明：1-左上, 2-上中, 3-右上, 4-左下, 5-下中, 6-右下
- 边距说明：10/30/60
拆分PDF (split_pdf)
- 按页码范围拆分PDF文档
- 输入: files 文件列表, pages 拆分页面规则, split_type 拆分类型(page), merge_all 是否合并(1)
合并PDF (merge_pdfs)
- 将多个PDF文件合并为一个
- 输入: files 要合并的PDF文件列表
压缩PDF (compress_pdf)
- 优化PDF文件大小，可调整图像质量
- 输入: files 文件列表, image_quantity 图像质量(1-100, 默认60)
加密PDF (protect_pdf)
- 为PDF文档添加密码保护
- 输入: files 文件列表, password 要设置的新密码
解密PDF (unlock_pdf)
- 移除PDF文档的密码保护
- 输入: files 文件列表（包含密码）
旋转PDF (rotate_pdf)
- 旋转PDF文档的页面
- 输入: files 文件列表, rotates 旋转参数列表
- 旋转参数格式: [{"angle": 90, "pages": "1-3"}, {"angle": 180, "pages": "4-6"}]
- 角度说明：90/180/270
去除白边 (remove_margin)
- 去除PDF文档的白边（裁剪去掉页面边距）
- 输入: files 文件列表
提取图片 (extract_images)
- 从PDF文件中提取图片资源
- 输入: files 文件列表, format 图片格式(bmp/png/gif/tif/jpg, 默认png)

输出: 包含可供下载的文件的URL

配置说明

使用LightPDF Agent MCP Server需要先获取API密钥，并在您的操作系统上进行配置。在配置之前，请先从轻闪PDF开发者平台获取API密钥。

环境依赖

使用LightPDF Agent MCP Server需要以下环境依赖：

Python 3.8 或更高版本
uv 包管理器

安装步骤

安装 uv 包管理器：

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

确保已安装 Python 3.8 或更高版本，如果未安装，使用以下命令安装：
```
uv python install 3.12
```

使用 uv 安装 MCP Server：

uv tool install lightpdf-aipdf-mcp@latest

MCP 配置文件

Cursor安装完成后，MCP配置文件会自动创建，您只需编辑此文件添加以下内容：

{
  "mcpServers": {
    "lightpdf": {
      "command": "uvx",
      "args": [
        "lightpdf-aipdf-mcp@latest"
      ],
      "env": {
        "API_KEY": "your_api_key_here",
        "API_ENDPOINT": "techsz.aoscdn.com/api"
      }
    }
  }
}

配置文件路径：

macOS/Linux: ~/.cursor/mcp.json
Windows: C:\\Users\\用户名\\.cursor\\mcp.json

* API_KEY 需要替换为您从轻闪PDF开发者平台获取的密钥

配置完成后，重启客户端使配置生效。您可以与AI对话以使用 LightPDF Agent的各项功能处理文档，无需编写任何代码。

特点优势

符合MCP协议，易于集成
支持多种文档格式的转换
提供完整的PDF文件处理功能
支持本地文件和网络URL
支持批量转换和并发处理
支持密码保护的PDF文件处理
支持自定义水印和页码
支持图片提取和页面旋转
支持去除白边优化页面布局
支持长图转换
支持CAD/CAJ/OFD格式转换