# MCP Watermark - PDF 水印工具

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

## 功能特点

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

## 快速开始

### 安装

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

### 在 Cursor 中配置

添加到 Cursor 设置文件（`settings.json`）：

```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 文件信息 |

## 使用示例

### 添加文字水印

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

### 添加图片水印

```json
{
  "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