@alisaitteke/photoshop-mcp 1.3.12 → 1.3.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
# Photoshop MCP Server
|
|
2
2
|
|
|
3
|
+
<p align="center">
|
|
4
|
+
<a href="https://github.com/alisaitteke/photoshop-mcp">
|
|
5
|
+
<img src="./images/readme-hero.png" alt="Photoshop MCP — AI-driven Photoshop automation" width="100%" />
|
|
6
|
+
</a>
|
|
7
|
+
</p>
|
|
8
|
+
|
|
3
9
|
*v1.1+ — recipe workflows, fewer round-trips, snappier sessions. Standalone UI ships **Action Plan (beta)** for plan-then-execute runs.*
|
|
4
10
|
|
|
5
11
|
> **Note:** This is an unofficial, community-maintained project and is not affiliated with or endorsed by Adobe Inc.
|
|
@@ -13,6 +19,14 @@
|
|
|
13
19
|
|
|
14
20
|
A Model Context Protocol (MCP) server that enables AI assistants like Claude and Cursor to control Adobe Photoshop programmatically. This allows you to create designs, manipulate images, and automate Photoshop workflows through natural language commands while working in your IDE — or through the bundled **standalone web UI**, which supports both API keys and CLI subscription accounts (Claude Code / Gemini CLI). The UI also offers an opt-in **Action Plan (beta)** mode that plans every Photoshop step in one LLM call, then runs them in a single pass.
|
|
15
21
|
|
|
22
|
+
## Why this exists
|
|
23
|
+
|
|
24
|
+
Designers and developers want to drive Photoshop from AI assistants, but raw ExtendScript calls are brittle: agents waste tokens on trial-and-error, layer types break filters, and one failed command leaves the document in an unknown state.
|
|
25
|
+
|
|
26
|
+
Photoshop MCP adds **state awareness** (`get_state`, `get_preview`, `get_capabilities`), **recipe tools** that wrap multi-step outcomes in a single undo step, and **structured error envelopes** so agents know what to try next. The optional standalone UI and Action Plan mode reduce round-trips for longer workflows — so natural language can actually ship pixels, not just suggest them.
|
|
27
|
+
|
|
28
|
+
Engineering deep-dive: [`docs/architecture.md`](docs/architecture.md).
|
|
29
|
+
|
|
16
30
|
## 🖥️ Standalone UI (no IDE required)
|
|
17
31
|
|
|
18
32
|
Don't want to wire this into Claude Desktop or Cursor? The same package ships a
|
|
@@ -636,13 +650,33 @@ From-source setup, build, lint, integration tests (with latest results), and usa
|
|
|
636
650
|
|
|
637
651
|
## Architecture
|
|
638
652
|
|
|
639
|
-
|
|
653
|
+
System design, data flow, platform abstraction, and UI agent modes:
|
|
640
654
|
[`docs/architecture.md`](docs/architecture.md).
|
|
641
655
|
|
|
656
|
+
Sharing on LinkedIn or social? Use [`images/og-social.png`](images/og-social.png) and
|
|
657
|
+
[`docs/social-preview.md`](docs/social-preview.md) for OG setup and post copy.
|
|
658
|
+
|
|
642
659
|
## Contributing
|
|
643
660
|
|
|
644
661
|
Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a PR.
|
|
645
662
|
|
|
663
|
+
## About the maintainer
|
|
664
|
+
|
|
665
|
+
**[Ali Sait Teke](https://alisait.com)** — Full-Stack engineer & AI-era software architect
|
|
666
|
+
(Python, Go, Node.js, React, Next.js, Vue).
|
|
667
|
+
|
|
668
|
+
This project started from a practical question: *how do you make Photoshop reliably
|
|
669
|
+
controllable by LLMs without fragile one-off scripts?* It grew into an MCP server
|
|
670
|
+
with 80 tools, a recipe/prompt layer for dependable multi-step workflows, and a
|
|
671
|
+
local web UI so creative work does not require an IDE.
|
|
672
|
+
|
|
673
|
+
**What this codebase demonstrates:** TypeScript systems design, MCP protocol
|
|
674
|
+
integration, cross-platform desktop automation (macOS AppleScript / Windows COM),
|
|
675
|
+
structured error recovery for agentic loops, and a production-minded local-first UI
|
|
676
|
+
(Vue 3 + Hono + SQLite).
|
|
677
|
+
|
|
678
|
+
- [Portfolio](https://alisait.com) · [GitHub](https://github.com/alisaitteke) · [LinkedIn](https://www.linkedin.com/in/alisait/)
|
|
679
|
+
|
|
646
680
|
## License
|
|
647
681
|
|
|
648
682
|
MIT
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@alisaitteke/photoshop-mcp",
|
|
3
|
-
"version": "1.3.
|
|
4
|
-
"description": "MCP server for Adobe Photoshop
|
|
3
|
+
"version": "1.3.13",
|
|
4
|
+
"description": "MCP server for Adobe Photoshop — 80 AI tools, recipe workflows, standalone web UI. Control Photoshop from Cursor, Claude, or natural language.",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"bin": {
|
|
@@ -38,14 +38,22 @@
|
|
|
38
38
|
},
|
|
39
39
|
"keywords": [
|
|
40
40
|
"mcp",
|
|
41
|
+
"model-context-protocol",
|
|
41
42
|
"photoshop",
|
|
42
43
|
"adobe",
|
|
43
44
|
"automation",
|
|
44
45
|
"ai",
|
|
45
|
-
"
|
|
46
|
-
"
|
|
46
|
+
"ai-agents",
|
|
47
|
+
"cursor",
|
|
48
|
+
"claude",
|
|
49
|
+
"image-editing",
|
|
50
|
+
"typescript",
|
|
51
|
+
"extendscript",
|
|
52
|
+
"developer-tools",
|
|
53
|
+
"vue",
|
|
54
|
+
"hono"
|
|
47
55
|
],
|
|
48
|
-
"author": "Ali Sait Teke",
|
|
56
|
+
"author": "Ali Sait Teke (https://alisait.com)",
|
|
49
57
|
"license": "MIT",
|
|
50
58
|
"repository": {
|
|
51
59
|
"type": "git",
|