Adobe Photoshop MCP工具

Requirements

• Photoshop: Adobe Photoshop 2022+ (UXP support required)
• Python (pip path only): Python 3.8+
• Dependencies (auto-installed with pip):
• dcc-mcp-core >= 0.18.14, < 1.0.0
• adobepy >= 0.1.0
• websockets >= 12.0
• Build (to build standalone binary from source): Python 3.8+, Rust toolchain, and PyOxidizer (pip install pyoxidizer)

1. Download & Install the UXP plugin

Download the latest .ccx from GitHub Releases, install via Creative Cloud Desktop, and restart Photoshop.

The plugin automatically starts the bundled sidecar (bridge + MCP server) when Photoshop loads.

One-Click Setup

load_skill("photoshop-setup")

Installation

Gateway Mode (Recommended for Deployment)

This mode uses the standalone dcc-mcp-server for the MCP server and dcc-mcp-photoshop as a lightweight bridge plugin.

Terminal 1 — Start the MCP server (Rust binary, no Python needed):

dcc-mcp-server --dcc photoshop --mcp-port 8765 \
  --skill-paths ./skills --no-bridge \
  --gateway-port 9765 --registry-dir ~/.dcc-mcp/registry

Terminal 2 — Start the bridge plugin:

python -m dcc_mcp_photoshop

MCP clients connect to the gateway URL: - http://127.0.0.1:9765/mcp — Gateway proxy (recommended): unified facade for all DCCs, auto-discovers the correct DCC on each call - http://127.0.0.1:8765/mcp — Direct access (useful for debugging or single-DCC setups)

The gateway /mcp endpoint aggregates tools from ALL registered DCCs (Maya, Houdini, Blender, Photoshop, etc.). On tools/call, the gateway auto-discovers the correct DCC instance via the capability index.

UXP Plugin Setup (Development)

The UXP plugin lives at bridge/uxp-plugin/. To load from source in Photoshop:

1. Open Photoshop
2. Go to Plugins → Development → Load Plugin...
3. Navigate to bridge/uxp-plugin/ and select manifest.json
4. The plugin appears in the Plugins panel as "dcc-mcp Bridge"

Quick Start

Download the latest release binary (example: Linux)

curl -LO https://github.com/dcc-mcp/dcc-mcp-photoshop/releases/latest/download/dcc-mcp-photoshop-linux chmod +x dcc-mcp-photoshop ./dcc-mcp-photoshop --help ```

2. Configure your MCP client

Point your MCP client to the gateway URL. The gateway auto-discovers which DCC (Photoshop, Maya, etc.) to route each tool call to, so you only need one endpoint:

{
  "mcpServers": {
    "photoshop": {
      "url": "http://127.0.0.1:9765/mcp"
    }
  }
}

Configuration

MCP Client Configuration

Claude Desktop

{
  "mcpServers": {
    "photoshop": {
      "url": "http://127.0.0.1:9765/mcp"
    }
  }
}

The gateway URL (:9765) is a unified facade that aggregates tools from all registered DCCs. On tools/call, the gateway auto-discovers the correct DCC instance via the capability index — no need to specify the DCC type in the URL.

Embedded mode via command:

{
  "mcpServers": {
    "photoshop": {
      "command": "dcc-mcp-photoshop",
      "args": ["--embedded"],
      "env": {}
    }
  }
}

Cursor

In Cursor Settings → Features → MCP Servers:

Name: photoshop
Type: url
URL: http://127.0.0.1:9765/mcp

VS Code (via MCP extension)

{
  "mcp": {
    "servers": {
      "photoshop": {
        "command": "dcc-mcp-photoshop",
        "args": ["--embedded"]
      }
    }
  }
}

Environment Variables

Setting custom skill paths

export DCC_MCP_PHOTOSHOP_SKILL_PATHS=/path/to/my/skills
dcc-mcp-photoshop --embedded --skill-paths /path/to/my/skills

CLI Reference

dcc-mcp-photoshop [OPTIONS]

Options:
  --embedded          Embedded mode: MCP server + bridge in one process (dev only)
  --mcp-port PORT     MCP HTTP server port (embedded mode; default: 8765)
  --ws-port PORT      WebSocket bridge port for UXP plugin (default: 9001)
  --ws-host HOST      WebSocket bind host (default: localhost)
  --rpc-port PORT     HTTP RPC server port for cross-process bridge access (default: 9100)
  --gateway-port PORT Gateway competition port (embedded mode; default: 9765)
  --server-name NAME  Server name reported in MCP initialize (default: photoshop-mcp)
  --skill-paths PATH  Extra skill directories
  --no-builtins       Do not discover built-in skills
  --verbose, -v       Enable debug logging
  --version           Show version and exit

Python API

```python import dcc_mcp_photoshop

handle = dcc_mcp_photoshop.start_server(port=8765, ws_port=9001) print(f"MCP URL: {handle.mcp_url()}")

UXP .ccx Plugin

Install the .ccx into Photoshop if you only need the UXP sidecar:

1. Download the .ccx from the latest release assets
2. Open Creative Cloud Desktop → Plugins → Manage Plugins
3. Click the gear icon → Install from file...
4. Select the downloaded .ccx file
5. Restart Photoshop

Manual install:

```powershell

Plugin manifest

bridge/uxp-plugin/manifest.json declares:

v0.2.0 — UXP Plugin + Bridge ✅

• UXP plugin WebSocket client (JavaScript)
• Python bridge WebSocket server
• JSON-RPC 2.0 protocol implementation
• Release distribution (pip, binary, .ccx)
• 20+ Photoshop skills
• Cross-process RPC bridge

UXP plugin does not connect

1. Ensure Photoshop 2022+ is running
2. Check the plugin is loaded: Plugins → Development → Load Plugin... → select manifest.json
3. Verify the panel shows "Connected" status
4. Check the bridge log file at ~/.dcc-mcp/logs/photoshop-bridge.log

Troubleshooting