PDF Modifier

Name: PDF Modifier
Author: mlorentedev

本地服务

github.com/mlorentedev生产力32 天前更新

代码仓库

关于 PDF Modifier

PDF Modifier 是面向 PDF 批量处理和自动化工作流的命令行工具、MCP 服务与 Web 界面，可替换文本并保留字体样式。它还支持正则替换、超链接操作和版面检查。

主要功能

01替换文本并保留字体样式
02正则表达式批量替换
03创建或取消超链接
04批量处理多个 PDF
05浏览结构并预览页面
06读取结构、字体和链接信息

适用场景

01批量更新 PDF 中的文本
02在脚本或 CI 流程中处理文件
03检查页面布局与字体
04创建或停用 PDF 超链接

MCP 相关

MCP 服务向 AI Agent 提供读取 PDF 结构、检查字体、列出超链接和修改内容的工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "mlorentedev-pdf-modifier": {
      "command": "uvx",
      "args": [
        "pdf-modifier-mcp"
      ]
    }
  }
}

启动命令uvx pdf-modifier-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypipdf-modifier-mcp1.6.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
password	any	否	如果 PDF 已加密，则可选填密码。
input_path	string	是	要分析的 PDF 文件的绝对路径。必须是有效且可访问的 PDF 文件。
max_file_size	integer	否	允许的最大输入文件大小，以字节为单位（默认值：100 MB）。

详细介绍

PDF 修改器

命令行工具 + MCP 服务 + Web UI，可替换 PDF 文本并保留字体样式。

快速开始

pip install pdf-modifier

# CLI
pdf-mod modify input.pdf output.pdf -r "Draft=Final"

# MCP server (for Claude/Cursor/Codex)
claude mcp add -s user pdf-modifier -- uvx pdf-modifier

接口

接口	描述	运行方式
命令行工具	`pdf-mod` — 批处理任务、脚本和 CI 流水线	`make run cli ARGS="..."`
MCP 服务	`pdf-modifier` — AI Agent 编辑 PDF	`make run mcp`
Web UI	FastAPI + SvelteKit — 拖放、预览和替换	`make up`（Docker）或 `make run api` + `make run frontend`

功能

文本替换 — 查找并替换文本，同时保留字体样式（字体系列、粗细、大小、颜色）
正则表达式支持 — 基于模式进行批量替换（--regex）
超链接 — 创建可点击的链接，或取消现有链接的作用
批处理 — 对多个文件应用相同的替换
Web UI — 拖放上传 PDF、结构浏览器、支持缩放的页面预览和文本高亮
MCP 工具 — read_pdf_structure、inspect_pdf_fonts、list_pdf_hyperlinks、modify_pdf_content

开发

# Setup
make setup

# Run tests
make test

# Full check (lint + type + test)
make check

# Start dev stack (Docker)
make up
# API: http://localhost:8000 | Web: http://localhost:8080

# Start servers locally
make run api          # FastAPI dev server
make run frontend     # SvelteKit dev server