Photoshop Comfyui MCP Bridge

Photoshop ComfyUI MCP 桥接（或：Photoshop ComfyUI MCP 桥接工具）

一个全面的集成系统，能够将Adobe Photoshop与ComfyUI和MCP（模型上下文协议）连接起来，实现支持全遮罩的AI图像处理工作流。

🌟 特点

核心功能

• 获取活动文档 - 将当前Photoshop文档导出为图像
• 创建图层 - 生成带有可选图像内容的新图层
• 创建文档 - 通过编程创建新的Photoshop文档
• 文档信息 - 获取详细的文档信息

口罩支持

• 通道提取 - 提取RGB/Alpha通道作为遮罩
• 图层蒙版 - 获取并应用图层蒙版
• 掩码操作 - 反转和操作遮罩
• 通道到遮罩 - 将任意通道本地转换为掩码

🏗️ 建筑学

┌─────────────────┐         ┌──────────────────┐
│   ComfyUI       │◄────────┤  Node.js Bridge  │
│   Custom Nodes  │  HTTP   │     Server       │
└─────────────────┘         └──────────────────┘
                                      │
                                      │ WebSocket
                                      ▼
┌─────────────────┐         ┌──────────────────┐
│   MCP Server    │◄────────┤  Photoshop UXP   │
│   (Chatbots)    │  HTTP   │     Plugin       │
└─────────────────┘         └──────────────────┘

📦 组件

1. UXP 插件 (uxp-plugin/) - 搭载API接口的Photoshop扩展程序
2. ComfyUI 节点 （comfyui-nodes/- 用于ComfyUI工作流的自定义节点
3. MCP 服务器 (mcp-server/) - 用于AI助手的MCP工具
4. 桥接服务器 （bridge-server/- Node.js HTTP/WebSocket 桥接器

🚀 快速入门

先决条件

• Adobe Photoshop 2023版或更高版本
• ComfyUI 已安装
• Node.js 18+（用于桥接服务器）
• Python 3.10+（用于MCP服务器）

安装

1. 安装桥接服务器

cd bridge-server
npm install
npm start

桥接服务器运行在 http://localhost:3000 (HTTP) 和 ws://localhost:3001 (WebSocket)（中文可译为“（网络套接字）”，但通常直接使用“WebSocket”这一术语，因其已成为行业标准）

2. 安装UXP插件

1. 打开Adobe UXP开发者工具
2. 添加插件 → 选择 uxp-plugin/manifest.json
3. 加载插件
4. 该插件将自动连接到桥接服务器

3. 安装ComfyUI节点

cd ComfyUI/custom_nodes/
git clone https://github.com/TheWhykiki/photoshop-comfyui-mcp-bridge.git
cd photoshop-comfyui-mcp-bridge/comfyui-nodes
pip install -r requirements.txt

重启ComfyUI。节点将出现在 Photoshop 类别。

4. 安装MCP服务器

cd mcp-server
pip install -r requirements.txt
python server.py

在您的MCP客户端配置（例如，Claude Desktop）中添加：

{
  "mcpServers": {
    "photoshop": {
      "command": "python",
      "args": ["/path/to/mcp-server/server.py"]
    }
  }
}

📚 使用示例

ComfyUI 工作流示例

[PS Get Active Image] → [Image Processing] → [PS Create Layer]
         ↓
[PS Get Channel Mask (Red)] → [Mask Processing] → [PS Apply Mask]

MCP 示例（与 Claude 一起）

User: "Extract the red channel from my Photoshop document as a mask"
Claude: *uses get_channel_as_mask tool with channel="red"*

直接API示例

// Get active document
const response = await fetch('http://localhost:3000/api/getActiveDocImage');
const data = await response.json();
console.log(`Image: ${data.width}x${data.height}px`);

🎨 可用节点

ComfyUI 节点

| mask | MASK | 反转遮罩值 |

• create_document MCP 工具
• get_document_info - 创建新的Photoshop文档
• export_active_image - 获取活动文档信息
• create_layer - 将文档导出为图像
• get_channel_as_mask - 创建带有可选图像的图层
• get_layer_mask - 提取通道作为掩码
• apply_mask_to_layer - 获取图层蒙版

- 对图层应用蒙版

🔧 配置bridge-server/config.json桥接服务器（

{
  "http_port": 3000,
  "websocket_port": 3001,
  "allowed_origins": ["*"]
}

)

ComfyUI 节点 PS_API_URL 编辑 comfyui-nodes/nodes.py在

PS_API_URL = "http://localhost:3000"

：

MCP服务器 PS_API_URL 编辑 mcp-server/server.py在

PS_API_URL = "http://localhost:3000"

:

🐛 故障排除

1. “Photoshop未连接”
2. 确保桥接服务器正在运行
3. 重新加载UXP插件

在浏览器控制台中检查 WebSocket 连接

“没有活动文档”

在使用节点/工具之前，请先在Photoshop中打开一个文档。

1. ComfyUI 节点未显示 ComfyUI/custom_nodes/
2. 验证安装在
3. 检查控制台以查看导入错误

重启ComfyUI

🤝 贡献

1. 欢迎投稿！请：
2. 为仓库创建分支（或“克隆仓库”）
3. 创建一个特性分支
4. 做出你的更改

提交拉取请求

📄 许可证

MIT 许可证 - 详见 LICENSE 文件

• 🙏 致谢 基于
• Photoshop-Python-API-MCP服务器 由ComfyUI提供
• comfy 匿名 由MCP提供的

Anthropic（公司名，可译为“安萨里克”或根据官方中文译名使用）

• 📞 支持
• 问题：https://github.com/TheWhykiki/photoshop-comfyui-mcp-bridge/issues

讨论链接：https://github.com/TheWhykiki/photoshop-comfyui-mcp-bridge/discussions

• 🗺️ 路线图/发展路线图
• \[ \] 选择到遮罩转换
• \[ \] 支持多文档
• \[ \] 批处理
• \[ \] 图层效果支持
• \[ \] 智能对象集成
• \[ \] 创建调整图层
• \[ \] 文本图层操作