工具資訊
| 項目 | 值 |
|---|---|
| 名稱 | photoshop-mcp |
| 類型 | MCP server（stdio） |
| GitHub | kathan3009/photoshop-mcp |
| Stars | 0（2026-10-23 剛發布，本文發布時尚無社群採用紀錄） |
| 語言 | JavaScript（Node.js，ESM） |
| 授權 | MIT |
| 安裝 | git clone https://github.com/kathan3009/photoshop-mcp.git && cd photoshop-mcp && ./scripts/install.sh --client claude-code |
解決什麼問題
你請 Claude 幫忙在 Photoshop 裡做一批調色、去背、裁切，最怕的不是「agent 不會用 Photoshop」，而是它改壞了你沒備份的原始 PSD、或是切換文件時把編輯動作套到你手上正在看的另一張圖上。多數「讓 AI 控制 Photoshop」的方案都停在「能呼叫幾個 API」這一層，沒有處理這類會真的毀掉工作成果的邊界情況。
photoshop-mcp 透過 AppleScript 橋接本機跑的 Photoshop，把每一次操作包成 ExtendScript 交易：失敗就自動回滾成一個 undo step，不會留下半套改動。更關鍵的是三層安全機制——每個 MCP session 會「釘住」第一次動到的文件，就算你後來手動切到別的檔案，agent 的下一步仍對準原本那份；第一次編輯前自動存一份歷史快照加上磁碟上的分層備份（~/Library/Application Support/photoshop-mcp/checkpoints，預設留最新 20 份或 7 天）；儲存既有檔案需要明確傳 overwrite: true，關閉未儲存的文件需要 discard: true。工具呼叫前會先用 ps_render 把畫面轉成 sRGB 圖片讓 agent「看到」結果，而不是憑空猜 Photoshop 的狀態。作者在 README 裡列了一整張「Photoshop 這版本的怪癖」對照表（例如在選取群組內建圖層會被吃進群組、300 ppi 文件的像素單位換算），都是實測 Photoshop 27.11 跑出 40 份文件的真實編輯流程後修掉的。
適合場景：攝影師或設計師想讓 agent 幫忙跑一批調色、去背、裁切、轉檔的重複工作，但不想冒著毀掉原始檔案的風險；也適合想研究「MCP 工具怎麼設計安全邊界」的人——它把回滾、釘選、驗證這幾件事做得比「能動就好」細很多。
- agent 發出編輯請求，先鎖定目標文件
- 是這份文件第一次被編輯，就先建立 checkpoint
- 不是第一次，直接進入執行
- 把整個操作包成一個 ExtendScript 交易執行
- 成功就用 render 驗證結果並回傳；失敗就自動回滾成一個 undo step
簡化示意；省略 ps_exec 的額外 checkpoint 與逾時偵測。
快速上手
安裝
# 僅支援 macOS，需要已安裝並授權的 Photoshop、Node.js 18+
git clone https://github.com/kathan3009/photoshop-mcp.git
cd photoshop-mcp
./scripts/install.sh --client claude-code # 或 claude-desktop / cursor / codex
# 重啟 client、打開 Photoshop，請 agent 執行一次 ps_status
# 畫面會跳出 macOS 自動化授權請求，允許即可基本用法
# 透過內建的 psctl CLI 直接測試（不經過 agent）
psctl status # 文件、歷史、EXIF
psctl snapshot depth=2 # 圖層樹（含穩定 id）
psctl render out=/tmp/look.jpg maxSize=1200 # sRGB 預覽圖，agent 可以「看」
psctl adjustment type=hueSaturation \
params='{"reds":{"saturation":25}}' # 建一個色相/飽和度調整層
psctl history action=undo # 回滾上一步Agent 透過 MCP 拿到的是同一組 ps_* 工具（ps_status、ps_snapshot、ps_render、ps_adjustment、ps_mask、ps_history…），行為完全一致，只是換成自然語言下指令。
進階用法
# 把多個操作包成一個原子 undo step（任一步失敗全部復原）
psctl batch @grade.json
# 預設關閉的 ExtendScript 逃生口，只有明確開啟才能跑任意腳本
PS_MCP_ALLOW_EXEC=1 ./scripts/install.sh --client claude-code --exec與現有工具的比較
Photoshop 的 MCP 整合不是新點子，社群裡已經有 alisaitteke/photoshop-mcp（128 個工具、跨平台、內建聊天 UI）這類更成熟的方案。photoshop-mcp 選的是不同的切入點：犧牲平台覆蓋率，把力氣放在「改壞檔案」這個最痛的邊界情況上。
| photoshop-mcp | alisaitteke/photoshop-mcp | |
|---|---|---|
| 平台 | 僅 macOS | Windows + macOS |
| 工具數量 | ~20 個（涵蓋常見編輯操作） | 128 個（含一步到位的「食譜」） |
| 編輯前自動 checkpoint | ✅（歷史快照＋分層磁碟備份） | 依賴 Photoshop 原生 undo |
| 文件釘選（防止切錯檔案） | ✅ | 未見於文件 |
| 預設遙測／分析 | 無 | 預設開啟匿名使用分析（可關閉） |
| 內建聊天 UI | 無，需接 MCP client | 有（npx ... ui） |
| 社群採用程度 | 剛發布，0 star | 已上架 MCP Registry，有多語系文件與貢獻者 |
注意事項
- 目前只有 1 個發布後的 commit、0 星：這是本週才上線的新專案，雖然 CHANGELOG 顯示從 2026-10-08 就有實測迭代記錄，但還沒經過大量社群使用驗證，正式環境或重要檔案建議先用拋棄式檔案測過一輪。
- 僅支援 macOS：靠 AppleScript 驅動 Photoshop，Windows 需要等作者提到的 UXP 外掛方案。
ps_exec（任意 ExtendScript 執行）預設關閉：這是刻意的安全邊界，除非你完全信任傳入的腳本，不建議開啟PS_MCP_ALLOW_EXEC=1。- 只驗證過 Photoshop 27.11：其他版本未測試，
ps_status／doctor會標記「此版本未驗證」而不是直接失敗。
今日收穫
多數「讓 AI 控制 OO 軟體」的 MCP server 比的是工具數量和功能覆蓋，photoshop-mcp 選的是另一條路：先把「編輯失敗時怎麼不毀掉使用者的檔案」這個最容易被忽略、卻是生產環境裡最致命的問題解完，再對外發佈。工具數量少不一定是缺點，有時候代表作者先把安全邊界想清楚了。