Photoshop MCP Server
by StarBoze
Photoshop MCP Server is a project for remotely controlling Photoshop on macOS and Windows using the Model Context Protocol (MCP). It utilizes FastAPI to implement the MCP server and supports multiple backends for cross-platform compatibility.
Last updated: N/A
What is Photoshop MCP Server?
Photoshop MCP Server is a server application that allows you to remotely control Adobe Photoshop on macOS and Windows. It provides REST and WebSocket endpoints for various Photoshop operations, supporting different backends like AppleScript, PowerShell, and UXP plugins for cross-platform compatibility.
How to use Photoshop MCP Server?
To use Photoshop MCP Server, you need to install it using pip, configure the desired backend (AppleScript, PowerShell, or UXP), and start the server. You can then send API requests to control Photoshop, such as opening files, running actions, generating thumbnails, or performing automated retouching using LLMs. The server can be run in different modes (normal, foreground, debug, UXP) to suit your needs.
Key features of Photoshop MCP Server
REST/WebSocket endpoints using FastAPI/Starlette
Cross-platform support (macOS/Windows)
Photoshop control via AppleScript/PowerShell backends
Photoshop control via UXP Plug-in backend (WebSocket communication)
Plugin packaging functionality
Thumbnail generation (WebSocket streaming support)
Cluster mode for managing multiple Photoshop instances
LLM automated retouching
Use cases of Photoshop MCP Server
Automating image editing tasks with AI assistants
Batch processing of images for e-commerce or marketing
Integrating Photoshop into web applications and workflows
Performing automated retouching using LLMs
Managing multiple Photoshop instances for distributed processing
FAQ from Photoshop MCP Server
How do I install Photoshop MCP Server?
How do I install Photoshop MCP Server?
You can install it using pip: pip install photoshop-mcp-server or from source using git clone and pip install -e .
What are the system requirements?
What are the system requirements?
Python 3.11+, macOS or Windows 10/11, Adobe Photoshop 2023+
How do I start the server?
How do I start the server?
Use the command photoshop-mcp-server start. You can specify different bridge modes (applescript, powershell, uxp) using the --bridge-mode option.
How do I use the UXP backend?
How do I use the UXP backend?
Package the UXP plugin using photoshop-mcp-server package_plugin, install it using the Adobe UXP Developer Tool, and start the server with --bridge-mode uxp.
How do I use the LLM automated retouching feature?
How do I use the LLM automated retouching feature?
Send a POST request to the /autoRetouch endpoint with the image path and retouching instructions.