PsMCP - for Photoshop automates Photoshop tasks by exposing a Python-based toolbox through an MCP client. The server is designed to run a psMCP.py script that interfaces with Photoshop workflows, enabling automation like inserting text, resizing layers, exporting assets, and applying effects via programmable commands. You connect to this MCP server using a client (e.g., Claude, Cursor, or a Gradio/CLI client) and issue tool calls defined in psMCP.py routed through the MCP gateway. The example configuration shows the server being invoked via uv with a run command pointing at psMCP.py, allowing you to trigger the Python-based automation from your MCP environment.

To use, set up the environment variables (such as GEMINI_API_KEY for the demo Gradio client and directories for PSDs, assets, and exports), then run the application and configure your MCP client to point at the server. The server exposes a set of Photoshop automation tools defined in the underlying psMCP.py script, which can be invoked as tools from your MCP client to perform batch edits, asset generation, or scripted design pipelines.

Prerequisites:

• Python 3.8+ installed on your system
• Git (to clone the repository if needed)
• Access to the repository containing psMCP.py and related scripts

Step-by-step installation:

1. Clone the repository (or download the project files): git clone https://github.com/your/repo-for-psmcp.git cd repo-for-psmcp

2. Create and activate a Python virtual environment (recommended): python -m venv venv

   Windows

   venv\Scripts\activate

   macOS/Linux

   source venv/bin/activate

3. Install Python dependencies: pip install -r requirements.txt

4. Configure environment variables (see notes below) and ensure required directories exist:

   • GEMINI_API_KEY (for the Gradio Gemini client example)
   • PSD_DIRECTORY
   • EXPORT_DIRECTORY
   • ASSETS_DIR

5. Run the application (as shown in the README): python app.py

6. Configure your MCP client to connect to the server using the provided mcp_config example (PhotoshopAdv). Ensure the directory paths and script name psMCP.py are correct for your setup.

Notes:

• If you modify the Python script or dependencies, re-run the installation steps as needed.
• Ensure that Photoshop is accessible by the Python script if required by your workflow (this may vary by OS and Photoshop version).

Tips and notes:

• Environment variables: Set GEMINI_API_KEY for Gradio client usage and ensure PSD_DIRECTORY, EXPORT_DIRECTORY, and ASSETS_DIR point to valid, accessible paths.
• Command configuration: The sample MCP server uses the uv command to run psMCP.py. Adjust the directory and script path to match your setup.
• OS considerations: Windows paths were used in the example (e.g., D:\Photoshop Files). On macOS/Linux, convert paths to POSIX style (e.g., /Users/you/PhotoshopFiles).
• If tool calls are limited by the client (as noted in the README), use the MCP client as a test harness first and rely on the server for actual workflow automation.
• Ensure that any required Photoshop automation libraries or APIs are installed and compatible with your Photoshop version.