alisaitteke/photoshop-mcp

它解決的問題

Photoshop MCP 解決了透過 AI 助手控制 Adobe Photoshop 的困難。標準的自動化腳本通常很脆弱且缺乏上下文，導致 AI 代理在試錯上浪費大量 token，或使文件處於不一致的狀態。此專案提供了一個穩健的橋接工具，讓 AI 助手具備狀態感知能力，並以結構化的方式透過自然語言執行複雜的設計工作流程。

如何運作

它實現了一個 Model Context Protocol (MCP) 伺服器，讓 LLM（如 Claude 或 Cursor）能以程式化方式控制 Photoshop。系統具備：

• 狀態感知：get_state 和 get_preview 等工具讓 AI 可以查看目前的文件，並透過 base64 JPEG 驗證結果。
• 食譜工具：16 種高階「食譜」（例如背景移除、色彩調校），將多步驟流程包裝成單一可撤銷的操作。
• 提示層：23 個預先設計的範本，協助 LLM 將模糊的使用者請求轉換為精確的工具呼叫。
• 獨立 UI：一個本地網路介面，支援 API 金鑰或現有的 CLI 訂閱（Claude Code/Gemini CLI），無需 IDE 即可驅動 Photoshop。
• 行動計畫（測試版）：一種模式，可在一次 LLM 呼叫中規劃整個步驟序列，並單次執行以減少往返次數。

適用對象

希望自動化重複性 Photoshop 任務、建立資料驅動的圖形，或使用自然語言指令執行複雜影像操作的設計師與開發者。

特色亮點

• 共 118 種工具：包含 102 種原子工具與 16 種以結果為導向的食譜。
• 生成式 AI 整合：支援 Adobe Firefly 功能，如生成式填補、擴展與升級。
• 神經濾鏡支援：透過可選的 UXP 橋接外掛程式，存取皮膚平滑、景深模糊與色彩化功能。
• 非破壞性工作流程：食譜設計為單一撤銷步驟，以保留原始像素。
• 彈性驗證方式：支援多種提供者（Anthropic、OpenAI、Google、OpenRouter），透過 API 金鑰或 CLI OAuth 會話進行驗證。