PDF红框替换工具

一个用于检测和替换PDF文档中黑色红框的工具,适用于文档编辑和格式化处理。

  • by Justinandjohnson
  • CSS
  • 混合部署
  • 更新于
在 GitHub 查看 Justinandjohnson/unredactor-mcp

使用说明

解锁器MCP

一种模型上下文协议(MCP)服务器,允许AI助手检测和替换PDF文档中的黑色编辑框。

它做什么

此工具可帮助您 重写 PDF中的编辑框——就像数字文档的空白。

  • 检测 任何PDF页面上的黑色编辑框
  • 替换 带有自定义文本的特定尺寸框
  • 过程 整个文档或特定页面

备注:此工具不会“恢复”已编辑的数据。它只是用包含文本的白框替换黑框。

安装

选项1:通过pip安装(推荐)

pip install unredactor-mcp

然后添加到您的配置中:

{
  "mcpServers": {
    "unredactor": {
      "command": "unredactor-mcp"
    }
  }
}

选项2:Docker

docker pull justinandjohnson/unredactor-mcp
{
  "mcpServers": {
    "unredactor": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "justinandjohnson/unredactor-mcp"]
    }
  }
}

选项3:HTTP(远程)

通过HTTP传输使用公共托管版本:

{
  "mcpServers": {
    "unredactor": {
      "url": "https://unredactor-mcp-production.up.railway.app/mcp"
    }
  }
}

选项4:来源

git clone https://github.com/Justinandjohnson/unredactor-mcp
cd unredactor-mcp
pip install -e .

可用工具

工具 说明
upload_pdf 上传PDF(base64编码)进行处理
get_pdf_info 获取页数和尺寸
detect_black_boxes 在特定页面上查找编辑框
detect_all_pages 扫描整个PDF中的框
replace_redaction_boxes 用文本替换特定大小的框
download_pdf 获取修改后的PDF(base64编码)
cleanup_file 删除临时文件

使用示例

配置后,您可以询问Claude:

  1. “上传此PDF并扫描其中的编辑框”
  2. “将第1页上的所有100x20框替换为‘已分类’”
  3. “下载修改后的PDF”

GUI应用程序

独立的GUI应用程序也可用于手动编辑:

pip install PyMuPDF pillow opencv-python
python unredact.py

法律免责声明

  • 此工具仅用于取证和合法文档编辑目的
  • 它不会恢复真正销毁/编辑的数据
  • 重新发布更改的文件可能是非法的
  • 使用此工具,您将承担所有法律责任

已知限制

  • 将PDF页面转换为PNG并返回,这可能会增加文件大小
  • 字体大小保持不变,因此文本在多次编辑后可能会显得更小
  • 使用清晰的矩形黑框获得最佳效果

许可证

MIT许可证-请参阅 许可证 了解详情。