Photoshop Python Api MCP Server

🚀 Photoshop MCP Server

photoshop-mcp-server serves as a bridge that combines the capabilities of Photoshop with the Model Context Protocol (MCP), enabling AI assistants and other MCP clients to control Adobe Photoshop via a Python API.

[]

🚀 Quick Start

1. Environment Preparation

Ensure your system meets the following requirements:

• Operating System: Windows 7 or higher.
• Adobe Photoshop: Adobe Photoshop CC 2017 or higher.
• Python: Python 3.10 or higher.

2. Install Dependencies

pip install photoshop-python-api mcp_sdk

3. Example Code

The following is a simple example demonstrating how to use photoshop-mcp-server to create a new Photoshop document and add a text layer:

from photoshop_python_api import Photoshop
from mcp_sdk.server import MCPServer

# Initialize the Photoshop object
ps = Photoshop()

# Connect to Photoshop
if not ps.is_connected():
    ps.connect()

# Initialize the MCP server
server = MCPServer()

# Define tools
tools = {
    "create_document": lambda: ps.create_new_document(800, 600),
    "create_text_layer": lambda text: ps.create_text_layer(text)
}

# Register tools to the server
server.register_tools(tools)

# Start the server (run in a separate thread)
server.start()

# Example conversation: User requests to create a document with a text layer
user_message = "Please create a new Photoshop document and add a text layer containing 'Hello World'."
response = server.process(user_message)
print(response)

4. Function Examples

Create a New Document

User: Can you create a new Photoshop document for me?

AI Assistant: Sure! I'll create a brand - new Photoshop document for you.

[AI uses `photoshop-mcp-server` to perform the following actions:
1. Call the `create_document` tool to create a new blank document]

I've created a new Photoshop document for you.

Add a Text Layer

User: Please add a text layer containing 'Welcome' to the document.

AI Assistant: Okay, I'll add a 'Welcome' text layer to the document.

[AI uses `photoshop-mcp-server` to perform the following actions:
1. Call the `create_text_layer` tool to create and add a text layer]

The text layer has been successfully added to your document.

✨ Features

• Cross - platform Compatibility: Supports the Windows system.
• Powerful Photoshop Integration: Provides comprehensive control over Adobe Photoshop, including document operations, layer management, effect application, etc.
• MCP Protocol Support: Follows the Model Context Protocol standard, enabling seamless integration with AI assistants.

📦 Installation

pip install photoshop-mcp-server

📄 License

MIT

🙏 Acknowledgments

• photoshop-python-api - Provides a Python API interface for Photoshop.
• Model Context Protocol - Python SDK for the MCP protocol.