[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/chandrahas455-psmcp-mcp-server-for-photoshop-badge.png)](https://mseep.ai/app/chandrahas455-psmcp-mcp-server-for-photoshop)

# PsMCP-MCP-Server-for-Photoshop
Watch the Demo Below

[![Watch Demo Video](example/image.png)](https://media-hosting.imagekit.io/0e939780eeb24fd9/PhotoshopMCP.mp4?Expires=1841334328&Key-Pair-Id=K2ZIVPTIP2VGHC&Signature=sV1V82oUaMEfNTNYOHGeU7H9gLc8SsuNgQHRthU9j0exVXaC88plw8JiDTCj6IzHlKkToY0x5Xi4NzGndgHTQHKGrIpVHxJvWUCzcfWlq6LA2NEv9Fb4Yn0tDDSkJyWdTT9ISXlCvIXuBNVPgX4VT5TGB7KRM90vC6wIX31LH6DxX6qd4sVaY1o-ydx9gCe~hN9kSMx9IWMXc1NC50mgv~n5nOjgde8NJdrKJPB0WBZylW7BitIRCtiO2O2v6~C4x6bqbC~UTdQMdjldp0AwNTv2M2XT7NtrXsXA-QKOPa6Be0ysMMakMsAJc6xmMR25FJHdwap9ObgimCTZ4J9fIQ__)


## Usage

 **Install Requirements**

   Activate your Python environment and install dependencies:

   ```bash
   pip install -r requirements.txt
   ```
 **Run Using the Gradio Client Provided**
 
---

>  **Heads Up**: The Gemini Gradio client I've provided, for some reason does only a maximum of one tool call for any request, use this just to test the tool. For actual usage use Claude ot Cursor

---
 
   ![Gradio Example](example/gradio.png)
   Set Gemini Key in .env
   ```bash
   GEMINI_API_KEY = PASTE_YOUR_KEY_HERE
   ```
  Set Directories for PSDs, Assets and Exports
   ```bash
   PSD_DIRECTORY = "D:\\Photoshop Files"
   EXPORT_DIRECTORY = "D:\\PsMCP-Exports"
   ASSETS_DIR = "D:\\PsMCP-Assets"
   ```
  Run the App and connect to the Server
  
   ```bash
   python app.py
   ```
 **Configure Server with Any MCP Client (Claude, Cursor, etc)**

 Add Server to Config file as follows to access the tools
 
   ```bash
   {
    "mcpServers": {
      "PhotoshopAdv": {
        "command": "uv",
        "args": [
          "--directory",
          "Path/To/Directory",
          "run",
          "psMCP.py"
        ],
        "timeout": 60000 
      }
    }
  }
   ```
## Use Cases
- 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.