M
MCP Watermark
by @xecho-dev
mcp-watermark
Created 5/19/2026
Updated 1 day ago
README
Repository documentation and setup instructions
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
Quick Setup
Installation guide for this server
Install Package (if required)
uvx mcp-watermark
Cursor configuration (mcp.json)
{
"mcpServers": {
"xecho-dev-mcp-watermark": {
"command": "uvx",
"args": [
"mcp-watermark"
]
}
}
}