Auto Snap Mcp

Auto-Snap MCP 📸

为 MCP 客户端自动截屏和处理文档

自动将截图转换为 PDF！Auto-Snap 可让 MCP 客户端通过简单的自然语言命令捕获窗口、处理文档并创建 PDF。

🚀 快速开始

我应该选择哪个选项？

• 🐳 Docker → 无需设置，随处可用（推荐）
• 🪟 WSL2 → 已安装 WSL2 的 Windows 用户
• 🐧 Linux → 原生 Linux

设置步骤

1. 获取 Auto-Snap：

git clone https://github.com/your-repo/auto-snap-mcp
cd auto-snap-mcp

2. 安装依赖项（仅限 Linux）：

# Skip this step if using Docker
sudo apt install -y wmctrl xdotool tesseract-ocr
uv sync

3. 配置 Claude Desktop：

编辑 ~/.claude/claude_desktop_config.json，并添加以下其中一种配置：

🐳 Docker（推荐——无需设置！）

{
  "mcpServers": {
    "auto-snap-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "DISPLAY=:0", 
        "-v", "/tmp/.X11-unix:/tmp/.X11-unix:rw",
        "-v", "${HOME}/auto-snap-captures:/app/captures:rw",
        "mcp/auto-snap-mcp:latest"
      ]
    }
  }
}

🪟 WSL2（搭载 WSL2 的 Windows）

{
  "mcpServers": {
    "auto-snap-mcp": {
      "command": "wsl.exe",
      "args": [
        "bash", "-c",
        "cd /home/YOUR_WSL_USERNAME/auto-snap-mcp && DISPLAY=:0 /home/YOUR_WSL_USERNAME/.local/bin/uv run python server.py"
      ]
    }
  }
}

🐧 Linux 原生

{
  "mcpServers": {
    "auto-snap-mcp": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/home/YOUR_USERNAME/auto-snap-mcp",
      "env": {"DISPLAY": ":0"}
    }
  }
}

4. 重启 Claude Desktop，并确认运行正常：

• “列出所有已打开的窗口” ← 从这条命令开始，测试连接
• “捕获此 PDF 并转换为图片”
• “截取 5 张截图并将它们制作为 PDF”

✅ 运行正常吗？ 你应该会看到窗口列表。如果没有，请查看下方的🚨 无法运行？部分。

📁 文件保存位置

默认情况下，所有捕获的文件都会保存到：

~/auto-snap-captures/

完整路径示例：

• Linux：/home/username/auto-snap-captures/
• WSL2：/home/username/auto-snap-captures/
• Windows（Docker）：C:\Users\username\auto-snap-captures\

✨ 功能与可试用的命令

📋 捕获文档

• 截取任意窗口或整个屏幕
• 自动捕获多页文档
• 支持 PDF、演示文稿和网页

🔍 图像处理

• 从截图中提取文字（OCR）
• 自动提升图像质量
• 一次处理多张图片

📄 创建 PDF

• 即时将截图转换为 PDF
• 使用智能命名整理文件
• 压缩 PDF 以减小文件体积

🎯 可试用的命令

“将此文档捕获为 PDF” → 截取屏幕并创建 PDF

“从这些图片中提取文字” → 对截图进行 OCR

“归档此演示文稿” → 将所有幻灯片截取到一个 PDF 中

“列出所有已打开的窗口” → 查看可以捕获哪些内容

“截取 5 张截图并将它们制作为 PDF” → 捕获多页内容

💡 实用技巧：

• 具体描述：“捕获 Chrome 窗口” 比 “截屏” 效果更好
• 多步操作：“截取此演示文稿的屏幕并提取所有文字”
• 批量处理：“处理我下载文件夹中的所有图片并制作成 PDF”

想要更改文件的保存位置？请查看下方的🎨 自定义捕获内容部分。

🛠️ 系统支持

• ✅ Linux（原生 X11）
• ✅ WSL2（在 Linux 中使用 Windows 应用）
• ⚠️ macOS（搭配 XQuartz 使用——实验性支持）

🚨 无法运行？

常见解决方法：

# Check dependencies
uv run python -c "from capture import check_dependencies; print(check_dependencies())"

# Fix X11 display
export DISPLAY=:0

# Test the server
uv run python server.py

仍然无法解决？

1. 确认配置文件路径正确：~/.claude/claude_desktop_config.json
2. 修改配置后重启 Claude Desktop
3. 查看 Claude Desktop 日志中的错误

🎨 自定义捕获内容

设置文件保存位置：

export AUTO_SNAP_OUTPUT_DIR="$HOME/Documents/Screenshots"

按日期整理：

export AUTO_SNAP_USE_DATE_SUBDIRS=true
export AUTO_SNAP_INCLUDE_TIMESTAMP=true

自定义文件名：

export AUTO_SNAP_FILE_NAME_TEMPLATE="doc_{page:04d}"

🌍 多语言

添加更多 OCR 语言：

sudo apt install tesseract-ocr-spa  # Spanish
sudo apt install tesseract-ocr-fra  # French
sudo apt install tesseract-ocr-deu  # German

然后告诉 Claude：“用西班牙语处理此文档”

🔐 隐私

• 所有操作都在你的本地计算机上运行
• 不使用云服务，也不会上传内容
• 只捕获你要求的内容
• 自动清理临时文件

---

准备好自动处理截图了吗？ 安装 Auto-Snap，开始与 MCP 客户端交流文档吧！🚀