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数组操作
工作流程
- 截图已捕获并自动加载到编辑器中
- 所有编辑都应用于已加载的图像
- 编辑器维护历史记录（最多10个状态）
- 随时可撤销/重置
- 保存为所需格式
可用颜色
red，blue，green，yellow，black，white，orange
小贴士
- 步骤编号为不同的工作流程使用不同的颜色
- 模糊 vs 像素化轻微模糊以保护基本隐私，像素化以确保高度隐私
- 箭头方向箭头指向
end坐标 - 历史内存中最多可保存10个撤销状态
- 格式使用PNG格式以实现透明度，使用JPEG格式以减小文件大小
许可证
MIT 许可证 - 请参阅 许可证 详情请见文件。