AI导哈

截图与图像编辑工具

EditX是一款基于Linux的截图与图像编辑工具，提供屏幕截图、标注、形状绘制、特效处理等功能，适用于教程制作、隐私保护等场景。

  • by Retgex
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Retgex/EditX

使用说明

EditX - 截图及图片编辑器 MCP 服务器

用于截取屏幕截图并编辑带注释、形状和效果的图像的MCP服务器。受Linux版ShareX功能的启发。

特点/功能

📸 截图捕捉

  • 全屏截取整个屏幕
  • 区域选择交互式区域选择（图形用户界面）
  • 地区通过编程捕获特定坐标

✏️ 绘图工具

  • 箭头指向特定区域
  • 矩形突出显示区域
  • 步骤编号教程中的编号圆圈（1，2，3...）
  • 文本添加文本注释

🎨 效果

  • 模糊用于隐私保护的高斯模糊
  • 像素化更强的隐私保护效果（针对人脸、敏感数据）
  • 作物将图像裁剪到特定区域

💾 图片管理

  • 加载现有图像
  • 保存为PNG/JPEG格式
  • 撤销操作
  • 重置为原始设置
  • 图像信息及历史

安装

cd /path/to/EditX
pip install -r requirements.txt

系统依赖（Linux）

对于交互区域选择，请安装以下其中一款：

# Ubuntu/Debian
sudo apt install gnome-screenshot
# OR
sudo apt install scrot

配置

添加到 ~/.claude.json：

{
  "mcpServers": {
    "editx": {
      "type": "stdio",
      "command": "python",
      "args": [
        "/absolute/path/to/EditX/src/server.py"
      ]
    }
  }
}

替换 /absolute/path/to/EditX 使用你克隆此仓库的实际路径。

使用示例

基本工作流程

1. Take screenshot
   → take_screenshot(mode="fullscreen")

2. Add annotations
   → add_arrow(start_x=100, start_y=100, end_x=200, end_y=150)
   → add_rectangle(x=150, y=150, width=300, height=200)
   → add_step_number(x=250, y=250, number=1)

3. Add privacy blur
   → blur_region(x=400, y=100, width=200, height=50)

4. Save result
   → save_image(output_path="/path/to/annotated.png")

带步骤的教程截图

take_screenshot(mode="area")
add_step_number(x=100, y=100, number=1, bg_color="red")
add_step_number(x=100, y=200, number=2, bg_color="blue")
add_step_number(x=100, y=300, number=3, bg_color="green")
add_arrow(start_x=150, start_y=100, end_x=300, end_y=100)
save_image(output_path="tutorial.png")

隐私截图

take_screenshot(mode="fullscreen")
blur_region(x=100, y=100, width=300, height=200, blur_amount=20)
pixelate_region(x=500, y=500, width=200, height=200, pixel_size=15)
save_image(output_path="private.png")

编辑现有图像

load_image(image_path="/path/to/existing.png")
add_rectangle(x=50, y=50, width=400, height=300, color="red", border_width=5)
add_text(x=60, y=60, text="Important!", color="red", size=24, bg_color="white")
save_image(output_path="/path/to/annotated.png")

可用工具

截图工具

  • **take_screenshot**截屏
    • mode“全屏” | “区域” | “地区”
    • output_path（可选）保存位置
    • x, y, width, height（对于“区域”模式）

编辑工具

  • **load_image**加载现有图像文件

    • image_path图像路径

  • **add_arrow**画箭头

    • start_x, start_y箭头开始
    • end_x, end_y箭头位置
    • color箭头颜色
    • width线宽

  • **add_rectangle**绘制矩形

    • x, y左上角
    • width, height尺寸
    • color边框颜色
    • border_width边框粗细
    • fill（可选）填充颜色

  • **add_step_number**添加带编号的圆圈

    • x, y中心位置
    • number步骤编号（1，2，3...）
    • size圆的直径
    • bg_color圆圈颜色
    • text_color数字颜色

  • **add_text**添加文本注释

    • x, y文本位置
    • text文本内容
    • color文本颜色
    • size字体大小
    • bg_color（可选）背景

影响

  • **blur_region**模糊特定区域

    • x, y, width, height区域
    • blur_amount强度（5-50）

  • **pixelate_region**像素化区域（隐私保护）

    • x, y, width, height区域
    • pixel_size块大小（5-30）

  • **crop_image**裁剪到区域

    • x, y, width, height作物种植面积

管理

  • **save_image**保存编辑后的图像

    • output_path保存到哪里
    • format“PNG” | “JPEG”

  • **get_image_info**获取图像详情

  • **undo**撤销上一步操作

  • **reset_image**重置为原始设置

技术细节

建筑

EditX/
├── src/
│   ├── server.py        # MCP server (main entry)
│   ├── screenshot.py    # Screenshot capture (mss)
│   ├── editor.py        # Image editor manager
│   ├── shapes.py        # Drawing shapes (Pillow)
│   └── effects.py       # Image effects (Pillow + OpenCV)
├── requirements.txt
└── README.md

技术栈

  • MCP框架服务器实现
  • **python-mss（可直接作为译文，若需更具体说明，可译为“Python MSS模块”或“Python的MSS库”，具体取决于上下文）**快速跨平台截图
  • **枕头（PIL）**图像处理和绘图
  • **OpenCV（开源计算机视觉库）**高级效果（模糊、像素化）
  • NumPy数组操作

工作流程

  1. 截图已捕获并自动加载到编辑器中
  2. 所有编辑都应用于已加载的图像
  3. 编辑器维护历史记录（最多10个状态）
  4. 随时可撤销/重置
  5. 保存为所需格式

可用颜色

  • red， blue， green， yellow， black， white， orange

小贴士

  • 步骤编号为不同的工作流程使用不同的颜色
  • 模糊 vs 像素化轻微模糊以保护基本隐私，像素化以确保高度隐私
  • 箭头方向箭头指向 end 坐标
  • 历史内存中最多可保存10个撤销状态
  • 格式使用PNG格式以实现透明度，使用JPEG格式以减小文件大小

许可证

MIT 许可证 - 请参阅 许可证 详情请见文件。

相关 MCP