Skip to content

xecho-dev/mcp-watermark

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MCP Watermark - PDF 水印工具

一个为 PDF 文档提供水印功能的 Model Context Protocol(MCP)服务器。

功能特点

  • 文字水印:为所有页面添加斜角文字水印
  • 图片水印:为所有页面添加图片水印(徽标、图标)
  • 预览功能:预览 PDF 文件信息
  • 可自定义:支持字体大小、颜色、透明度、旋转角度、缩放

快速开始

安装

cd /path/to/mcp-watermark
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

在 Cursor 中配置

添加到 Cursor 设置文件(settings.json):

{
  "mcpServers": {
    "pdf-watermark": {
      "command": "/path/to/mcp-watermark/.venv/bin/python",
      "args": ["/path/to/mcp-watermark/pdf_watermark_server.py"]
    }
  }
}

可用工具

工具 说明
add_text_watermark 为所有页面添加斜角文字水印
add_image_watermark 为所有页面添加图片水印
preview_pdf 预览 PDF 文件信息

使用示例

添加文字水印

{
  "input_path": "/path/to/document.pdf",
  "output_path": "/path/to/output.pdf",
  "text": "机密文件",
  "font_size": 60,
  "color": "#FF0000",
  "opacity": 0.2,
  "rotation": -45
}

添加图片水印

{
  "input_path": "/path/to/document.pdf",
  "output_path": "/path/to/output.pdf",
  "image_path": "/path/to/logo.png",
  "opacity": 0.25,
  "scale": 0.5
}

项目结构

mcp-watermark/
├── pdf_watermark_server.py   # MCP 服务器主程序
├── requirements.txt          # Python 依赖
├── SKILL.md                  # MCP 工具文档
└── README.md                 # 本文件

环境要求

  • Python 3.10+
  • pypdf >= 4.0.0
  • mcp[cli] >= 1.1.0

许可证

MIT

About

mcp-watermark

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages