AI导哈

Photoshop控制服务

将Photoshop编辑工具作为确定性、可逆操作暴露的MCP服务器，使Claude能够通过工具调用控制Photoshop。

  • by CORE-Automate-WSS
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 CORE-Automate-WSS/photoshop-mcp

使用说明

Photoshop MCP服务器

MCP服务器，将Photoshop编辑工具作为确定性、可逆操作公开，使Claude能够通过工具调用控制Photoshop。

建筑

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  Claude/Client  │────▶│   MCP Server     │────▶│  UXP Plugin     │
│                 │◀────│  (Node.js)       │◀────│  (Photoshop)    │
└─────────────────┘     └──────────────────┘     └─────────────────┘
       stdio              WebSocket (8765)         batchPlay/DOM

快速开始

1.安装MCP服务器

cd packages/mcp-server
npm install
npm run build

2.在Photoshop中加载UXP插件

  1. 打开Adobe UXP开发工具（UDT）
  2. 点击“添加插件”并选择 packages/ps-uxp-bridge
  3. 点击“加载”将插件加载到Photoshop中
  4. 在Photoshop中，打开插件>MCP桥面板

3.连接插件

  1. 在MCP网桥面板中，确保WebSocket URL为 ws://localhost:8765
  2. 点击“连接”

4.配置克劳德桌面

添加到您的Claude桌面配置(%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "photoshop": {
      "command": "node",
      "args": ["C:\\SCRIPTS\\photoshopMCPTest\\packages\\mcp-server\\dist\\index.js"],
      "env": {
        "PS_BRIDGE_URL": "ws://localhost:8765"
      }
    }
  }
}

可用工具

应用

  • ps.app.get_info -获取Photoshop版本和平台信息
  • ps.echo -测试工具（无需Photoshop）

文档

  • ps.doc.get_active -获取活动文档信息
  • ps.doc.open -打开文档
  • ps.doc.save -保存当前文档
  • ps.doc.save_as -保存到新路径

层

  • ps.layer.list -列出所有图层
  • ps.layer.select -按ID选择图层
  • ps.layer.rename -重命名图层
  • ps.layer.set_visibility -显示/隐藏图层
  • ps.layer.set_opacity -设置图层不透明度

发展

测试MCP服务器

# Run the echo test (no Photoshop needed)
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ps.echo","arguments":{"message":"hello"}}}' | node packages/mcp-server/dist/index.js

调试

集 LOG_LEVEL=debug 对于详细日志记录：

LOG_LEVEL=debug node packages/mcp-server/dist/index.js

WebSocket架构

MCP服务器 运行WebSocket服务器 在端口8765上（可通过以下方式配置 PS_BRIDGE_PORT).

UXP插件充当WebSocket 客户端 它连接到MCP服务器。这意味着：

  1. 首先启动MCP服务器（它会自动启动WebSocket服务器）
  2. 然后从Photoshop连接UXP插件

项目结构

photoshop-mcp/
├── packages/
│   ├── mcp-server/           # Node.js MCP server
│   │   ├── src/
│   │   │   ├── index.ts      # Entry point
│   │   │   ├── tools/        # Tool definitions
│   │   │   ├── bridge/       # WebSocket client
│   │   │   └── logging/      # Audit logging
│   │   └── dist/             # Compiled output
│   │
│   └── ps-uxp-bridge/        # UXP Plugin
│       ├── manifest.json     # Plugin manifest
│       └── src/
│           ├── main.js       # Plugin entry
│           └── commands/     # Photoshop commands
│
├── docs/                     # Documentation
└── samples/                  # Example recipes

需求

  • Node.js 18+
  • Photoshop 23.3.0+（用于清单v5支持）
  • Adobe UXP开发工具

许可证

麻省理工学院

相关 MCP