Photoshop MCP Server
2025.05.03
0
Python图像处理自动化工具内容生成
Photoshop MCP Server 是一个基于FastAPI的远程控制Photoshop的项目，支持macOS和Windows平台。它通过REST/WebSocket接口提供对Photoshop的远程控制能力，支持多种后端方式（AppleScript、PowerShell、UXP插件）与Photoshop交互。项目具备跨平台兼容性、多实例管理、LLM自动修图等高级功能，适用于自动化图像处理、批量编辑等场景。
View on GitHub
Overview
基本能力
产品定位
Photoshop MCP Server 是一个用于远程控制Adobe Photoshop的中间件服务，旨在通过编程接口实现Photoshop操作的自动化。
核心功能
- 跨平台Photoshop控制（macOS/Windows）
- 多后端支持：
- AppleScript（macOS全版本）
- PowerShell（Windows全版本）
- UXP插件（Photoshop CC 2021+）
- REST API与WebSocket双接口
- 插件打包与安装功能
- 缩略图生成（支持流式传输）
- Cluster模式多实例管理
- LLM驱动的自动修图功能
- 性能优化（脚本缓存、并行处理等）
适用场景
- AI助手驱动的图像自动编辑
- 批量图像处理工作流
- 电子商务产品图像处理
- 摄影工作室后处理自动化
- 营销素材批量生成
- 图像存档优化
工具列表
- open_file - 在Photoshop中打开文件
- save_file - 保存当前文件
- run_action - 执行Photoshop动作
- generate_thumbnail - 从PSD生成缩略图
- auto_retouch - 使用LLM自动修图
常见问题解答
- 服务器启动失败：检查端口占用或尝试更换端口
- UXP插件连接问题：确认Photoshop已启动且插件正确安装
- 脚本执行错误：检查系统权限和Photoshop运行状态
- 性能问题：启用脚本缓存或使用Cluster模式
使用教程
使用依赖
# 创建虚拟环境
python -m venv venv
# 激活虚拟环境（macOS/Linux）
source venv/bin/activate
# 激活虚拟环境（Windows）
venv\Scripts\activate
安装教程
# 通过pip安装
pip install photoshop-mcp-server
# 或从源码安装
git clone https://github.com/StarBoze/photoshop-mcp-server.git
cd photoshop-mcp-server
pip install -e .
调试方式
# 前台调试模式
photoshop-mcp-server start --foreground --debug
# 检查日志文件
cat ~/.photoshop_mcp_server/logs/server.log