PsMCP-MCP-Server-for-Photoshop

What is PsMCP-MCP-Server-for-Photoshop?

PsMCP-MCP-Server-for-Photoshop connects MCP‑compatible AI assistants (like Claude and Cursor) to Adobe Photoshop. It exposes Photoshop actions as tools that can be called to automate image editing, layer management, and file export. This server is aimed at developers and designers who want to script Photoshop workflows through natural language or Python.

How to use PsMCP-MCP-Server-for-Photoshop?

Install dependencies from requirements.txt, set the required environment variables (GEMINI_API_KEY, PSD_DIRECTORY, EXPORT_DIRECTORY, ASSETS_DIR) in a .env file, then run app.py. For production use, configure the server in your MCP client’s settings file (e.g., Claude or Cursor) with the command uv --directory <path> run psMCP.py and a timeout of 60000–100000 ms. A Gradio client is provided for quick testing, but note it only makes at most one tool call per request.

Key features of PsMCP-MCP-Server-for-Photoshop

• Connects AI assistants to Adobe Photoshop tools.
• Automates repetitive tasks like resizing, text insertion, and export.
• Supports batch PSD editing with custom pipelines.
• Enables dynamic layer toggling and effect application.
• Integrates with Gemini API for optional test runs.

Use cases of PsMCP-MCP-Server-for-Photoshop

• Automate repetitive Photoshop tasks (e.g., inserting text, resizing, exporting).
• Build custom design pipelines for batch PSD editing.
• Rapidly generate marketing creatives from templates.
• Toggle layers or apply effects dynamically through Python scripts.
• Streamline creative asset versioning and export processes.

FAQ from PsMCP-MCP-Server-for-Photoshop

What does PsMCP-MCP-Server-for-Photoshop do?

It exposes Adobe Photoshop functions as MCP tools so that an AI assistant (Claude, Cursor, etc.) can control Photoshop actions directly from a chat interface or script.

How do I set up PsMCP-MCP-Server-for-Photoshop?

Install Python dependencies with pip install -r requirements.txt, create a .env file with your GEMINI_API_KEY and directory paths for PSDs, exports, and assets, then run python app.py.

What are the system dependencies?

The server requires Python and the packages listed in requirements.txt. It also needs Adobe Photoshop installed on the same machine to control it via scripting.

Are there any known limitations?

The included Gradio client (using Gemini) only executes a single tool call per request. For reliable multi‑step workflows you should use a full MCP client like Claude or Cursor.

How do I connect PsMCP-MCP-Server-for-Photoshop to my MCP client?

Add the server to your MCP client’s configuration file (e.g., mcpServers in Claude’s config) with the command uv --directory /path/to/server run psMCP.py and set an appropriate timeout.