@alisaitteke/photoshop-mcp 1.6.1 → 1.7.2
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/AGENTS.md +117 -0
- package/LICENSE +21 -0
- package/README.de.md +1 -1
- package/README.es.md +1 -1
- package/README.ja.md +1 -1
- package/README.md +2 -1
- package/README.tr.md +1 -1
- package/README.zh-CN.md +1 -1
- package/dist/platform/connection.d.ts +2 -0
- package/dist/platform/connection.d.ts.map +1 -1
- package/dist/platform/connection.js +17 -7
- package/dist/platform/connection.js.map +1 -1
- package/examples/claude-code-mcp.json +12 -0
- package/examples/claude-desktop-config.json +12 -0
- package/examples/cursor-config.json +11 -0
- package/llms.txt +72 -0
- package/package.json +9 -4
- package/uxp-plugin/main.js +1 -1
- package/uxp-plugin/manifest.json +3 -2
package/AGENTS.md
ADDED
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
# AGENTS.md — photoshop-mcp
|
|
2
|
+
|
|
3
|
+
> **Navigation map, not a reference manual.**
|
|
4
|
+
> Start with [llms.txt](llms.txt) or the site index [llms.txt](https://alisaitteke.github.io/photoshop-mcp/llms.txt), then follow links as needed.
|
|
5
|
+
|
|
6
|
+
## Entry strategy
|
|
7
|
+
|
|
8
|
+
| Scenario | Path |
|
|
9
|
+
| -------- | ---- |
|
|
10
|
+
| Cursor / Claude Desktop / VS Code | Configure `mcpServers` → `npx -y @alisaitteke/photoshop-mcp` (stdio) |
|
|
11
|
+
| Claude Code | `claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp` |
|
|
12
|
+
| Standalone chat UI (no IDE) | `npx -p @alisaitteke/photoshop-mcp photoshop-mcp-ui` |
|
|
13
|
+
| Local development | `npm install && npm run build && node dist/index.js` — see [docs/development.md](docs/development.md) |
|
|
14
|
+
|
|
15
|
+
**Prerequisites:** Photoshop running on Windows or macOS, Node.js 18+. This is unofficial and not affiliated with Adobe.
|
|
16
|
+
|
|
17
|
+
## Architecture (agent view)
|
|
18
|
+
|
|
19
|
+
```
|
|
20
|
+
AI host (Cursor / Claude / UI)
|
|
21
|
+
│ MCP stdio
|
|
22
|
+
▼
|
|
23
|
+
PhotoshopMCPServer (Node.js)
|
|
24
|
+
│ ExtendScript via AppleScript (macOS) or COM (Windows)
|
|
25
|
+
▼
|
|
26
|
+
Adobe Photoshop
|
|
27
|
+
|
|
28
|
+
Optional: UXP bridge plugin (uxp-plugin/) on 127.0.0.1:38452 for Neural Filters only.
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Deep dive: [docs/architecture.md](docs/architecture.md).
|
|
32
|
+
|
|
33
|
+
## Recommended workflow
|
|
34
|
+
|
|
35
|
+
Follow the server `instructions` advertised on MCP `initialize` ([src/prompts/instructions.ts](src/prompts/instructions.ts)):
|
|
36
|
+
|
|
37
|
+
```
|
|
38
|
+
1. DISCOVER: tools/list + prompts/list (or get_capabilities once per session)
|
|
39
|
+
2. STATE: photoshop_get_state before mutating; photoshop_get_preview after major steps
|
|
40
|
+
3. ACT: prefer photoshop_recipe_* for multi-step outcomes (single undo step)
|
|
41
|
+
4. RECOVER: on error, read structured envelope (code, suggested_next_tool) → get_state → retry one step
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
### Tool selection
|
|
45
|
+
|
|
46
|
+
| Need | Use |
|
|
47
|
+
| ---- | --- |
|
|
48
|
+
| Multi-step outcome (remove BG, export for web, portrait enhance) | `photoshop_recipe_*` |
|
|
49
|
+
| Single precise edit | atomic `photoshop_*` |
|
|
50
|
+
| Vague user intent | MCP prompt `prompts/get` (e.g. `ps.remove_background`) then call linked recipe/tool |
|
|
51
|
+
| Generative AI (Fill, Remove, Expand) | `photoshop_generative_*` — requires Adobe account + credits |
|
|
52
|
+
| Neural Filters (skin smooth, colorize, …) | `photoshop_neural_filter` — requires UXP bridge loaded |
|
|
53
|
+
| Version / feature check | `photoshop_get_capabilities` |
|
|
54
|
+
|
|
55
|
+
Full catalog: [docs/available-tools.md](docs/available-tools.md). Prompt layer: [docs/prompt-layer.md](docs/prompt-layer.md).
|
|
56
|
+
|
|
57
|
+
## MCP client configuration
|
|
58
|
+
|
|
59
|
+
```json
|
|
60
|
+
{
|
|
61
|
+
"mcpServers": {
|
|
62
|
+
"photoshop": {
|
|
63
|
+
"command": "npx",
|
|
64
|
+
"args": ["-y", "@alisaitteke/photoshop-mcp"],
|
|
65
|
+
"env": { "LOG_LEVEL": "1" }
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
Examples: [examples/cursor-config.json](examples/cursor-config.json), [examples/claude-desktop-config.json](examples/claude-desktop-config.json).
|
|
72
|
+
|
|
73
|
+
### Environment variables
|
|
74
|
+
|
|
75
|
+
| Variable | Purpose |
|
|
76
|
+
| -------- | ------- |
|
|
77
|
+
| `LOG_LEVEL` | `0`=DEBUG, `1`=INFO, `2`=WARN, `3`=ERROR |
|
|
78
|
+
| `PHOTOSHOP_PATH` | Optional custom Photoshop install path |
|
|
79
|
+
| `PSMCP_UI_TOKEN` | Pin standalone UI API token (see README) |
|
|
80
|
+
|
|
81
|
+
## Troubleshooting (common agent blockers)
|
|
82
|
+
|
|
83
|
+
| Symptom | Fix |
|
|
84
|
+
| ------- | --- |
|
|
85
|
+
| Photoshop not found | Start Photoshop; set `PHOTOSHOP_PATH` if non-standard install |
|
|
86
|
+
| Tool times out | Large operations may need retries; check `get_state` for partial progress |
|
|
87
|
+
| `generative_unavailable` / `version_unsupported` | Call `get_capabilities`; feature may need newer Photoshop or Adobe login |
|
|
88
|
+
| Neural filter fails | **Add Plugin** → `uxp-plugin/manifest.json` → **Load** in UXP Developer Tools — see [docs/development.md](docs/development.md#uxp-bridge-plugin-neural-filters) |
|
|
89
|
+
| No active document | Ask user to open/create a document, then `get_state` |
|
|
90
|
+
|
|
91
|
+
More: [docs/troubleshooting.md](docs/troubleshooting.md).
|
|
92
|
+
|
|
93
|
+
## Distribution
|
|
94
|
+
|
|
95
|
+
| Channel | Identifier |
|
|
96
|
+
| ------- | ---------- |
|
|
97
|
+
| npm | `@alisaitteke/photoshop-mcp` |
|
|
98
|
+
| MCP Registry | `io.github.alisaitteke/photoshop-mcp` |
|
|
99
|
+
| GitHub | https://github.com/alisaitteke/photoshop-mcp |
|
|
100
|
+
|
|
101
|
+
## Key files
|
|
102
|
+
|
|
103
|
+
| File | Purpose |
|
|
104
|
+
| ---- | ------- |
|
|
105
|
+
| [llms.txt](llms.txt) | LLM-oriented project summary |
|
|
106
|
+
| [README.md](README.md) | Human docs, install, example prompts |
|
|
107
|
+
| [server.json](server.json) | MCP Registry metadata |
|
|
108
|
+
| [src/core/server.ts](src/core/server.ts) | MCP server entry |
|
|
109
|
+
| [src/tools/](src/tools/) | Tool implementations |
|
|
110
|
+
| [src/prompts/](src/prompts/) | MCP prompt templates |
|
|
111
|
+
| [CONTRIBUTING.md](CONTRIBUTING.md) | PR and release workflow |
|
|
112
|
+
|
|
113
|
+
## Contributing (agents editing this repo)
|
|
114
|
+
|
|
115
|
+
- Canonical language for code, comments, commits, and PRs: **English**.
|
|
116
|
+
- Before PR: `npm run lint`, `npm run build:server`, `npm run verify:photoshop-prompts`.
|
|
117
|
+
- Do not add AI-attribution footers to commits or PR descriptions.
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Ali Sait Teke
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.de.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
</a>
|
|
7
7
|
</p>
|
|
8
8
|
|
|
9
|
-
**Sprachen:** [English](README.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · Deutsch · [日本語](README.ja.md) · [Türkçe](README.tr.md)
|
|
9
|
+
**Sprachen:** [English](README.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · Deutsch · [日本語](README.ja.md) · [Türkçe](README.tr.md) · **[Website](https://alisaitteke.github.io/photoshop-mcp/)**
|
|
10
10
|
|
|
11
11
|
*v1.1+ — Rezept-Workflows, weniger Round-Trips, flinkere Sitzungen. Die eigenständige UI liefert **Action Plan (Beta)** für Plan-dann-Ausführen-Abläufe.*
|
|
12
12
|
|
package/README.es.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
</a>
|
|
7
7
|
</p>
|
|
8
8
|
|
|
9
|
-
**Idiomas:** [English](README.md) · [简体中文](README.zh-CN.md) · Español · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md)
|
|
9
|
+
**Idiomas:** [English](README.md) · [简体中文](README.zh-CN.md) · Español · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md) · **[Sitio web](https://alisaitteke.github.io/photoshop-mcp/)**
|
|
10
10
|
|
|
11
11
|
*v1.1+ — flujos de trabajo con recetas, menos intercambios, sesiones más ágiles. La UI independiente incluye **Action Plan (beta)** para ejecuciones de planificar-y-ejecutar.*
|
|
12
12
|
|
package/README.ja.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
</a>
|
|
7
7
|
</p>
|
|
8
8
|
|
|
9
|
-
**言語：** [English](README.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md)
|
|
9
|
+
**言語：** [English](README.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md) · **[ウェブサイト](https://alisaitteke.github.io/photoshop-mcp/)**
|
|
10
10
|
|
|
11
11
|
*v1.1+ — レシピワークフロー、ラウンドトリップ削減、軽快なセッション。スタンドアロンUIには計画→実行を担う **Action Plan（ベータ）** が付属しています。*
|
|
12
12
|
|
package/README.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
</a>
|
|
7
7
|
</p>
|
|
8
8
|
|
|
9
|
-
**Languages:** English · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md)
|
|
9
|
+
**Languages:** English · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md) · **[Website](https://alisaitteke.github.io/photoshop-mcp/)**
|
|
10
10
|
|
|
11
11
|
*v1.1+ — recipe workflows, fewer round-trips, snappier sessions. Standalone UI ships **Action Plan (beta)** for plan-then-execute runs.*
|
|
12
12
|
|
|
@@ -19,6 +19,7 @@
|
|
|
19
19
|
[](https://www.typescriptlang.org/)
|
|
20
20
|
[]()
|
|
21
21
|
[](https://registry.modelcontextprotocol.io)
|
|
22
|
+
[](https://alisaitteke.github.io/photoshop-mcp/)
|
|
22
23
|
|
|
23
24
|
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.
|
|
24
25
|
|
package/README.tr.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
</a>
|
|
7
7
|
</p>
|
|
8
8
|
|
|
9
|
-
**Diller:** [English](README.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · Türkçe
|
|
9
|
+
**Diller:** [English](README.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · Türkçe · **[Website](https://alisaitteke.github.io/photoshop-mcp/)**
|
|
10
10
|
|
|
11
11
|
*v1.1+ — tarif iş akışları, daha az gidiş-dönüş, daha hızlı oturumlar. Bağımsız UI, plan-sonra-uygula çalıştırmaları için **Action Plan (beta)** sunar.*
|
|
12
12
|
|
package/README.zh-CN.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
</a>
|
|
7
7
|
</p>
|
|
8
8
|
|
|
9
|
-
**语言：** [English](README.md) · 简体中文 · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md)
|
|
9
|
+
**语言：** [English](README.md) · 简体中文 · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md) · **[网站](https://alisaitteke.github.io/photoshop-mcp/)**
|
|
10
10
|
|
|
11
11
|
*v1.1+ — 配方工作流、更少的往返调用、更流畅的会话。独立 UI 附带 **Action Plan（测试版）**，支持先规划后执行的运行模式。*
|
|
12
12
|
|
|
@@ -11,6 +11,8 @@ export declare class PhotoshopConnection {
|
|
|
11
11
|
private photoshopInfo;
|
|
12
12
|
private macosExecutor?;
|
|
13
13
|
constructor();
|
|
14
|
+
/** Returns the platform executor, initializing it on first call. */
|
|
15
|
+
private getExecutor;
|
|
14
16
|
ping(): Promise<boolean>;
|
|
15
17
|
getVersion(): Promise<string>;
|
|
16
18
|
executeScript(script: string, timeout?: number): Promise<unknown>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/platform/connection.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,QAAQ,
|
|
1
|
+
{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/platform/connection.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,aAAa,CAAC,CAAgB;;IAUtC,oEAAoE;IACpE,OAAO,CAAC,WAAW;IAeb,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBxB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAa7B,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA8BvE,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAIlC,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;CAY9C"}
|
|
@@ -6,13 +6,20 @@ import { MacOSExecutor } from './macos-executor.js';
|
|
|
6
6
|
export class PhotoshopConnection {
|
|
7
7
|
logger;
|
|
8
8
|
detector;
|
|
9
|
-
executor;
|
|
9
|
+
executor = null;
|
|
10
10
|
photoshopInfo = null;
|
|
11
11
|
macosExecutor;
|
|
12
12
|
constructor() {
|
|
13
13
|
this.logger = new Logger('PhotoshopConnection');
|
|
14
14
|
this.detector = new PhotoshopDetector();
|
|
15
|
-
//
|
|
15
|
+
// Executor is initialized lazily on first use so that constructing a
|
|
16
|
+
// PhotoshopConnection on an unsupported platform (e.g. the Linux CI runner
|
|
17
|
+
// used for the verify-photoshop-prompts script) does not throw immediately.
|
|
18
|
+
}
|
|
19
|
+
/** Returns the platform executor, initializing it on first call. */
|
|
20
|
+
getExecutor() {
|
|
21
|
+
if (this.executor)
|
|
22
|
+
return this.executor;
|
|
16
23
|
const platformType = platform();
|
|
17
24
|
if (platformType === 'win32') {
|
|
18
25
|
this.executor = new WindowsExecutor();
|
|
@@ -24,6 +31,7 @@ export class PhotoshopConnection {
|
|
|
24
31
|
else {
|
|
25
32
|
throw new Error(`Unsupported platform: ${platformType}`);
|
|
26
33
|
}
|
|
34
|
+
return this.executor;
|
|
27
35
|
}
|
|
28
36
|
async ping() {
|
|
29
37
|
try {
|
|
@@ -62,14 +70,15 @@ export class PhotoshopConnection {
|
|
|
62
70
|
if (this.macosExecutor && this.photoshopInfo.appName) {
|
|
63
71
|
this.macosExecutor.setAppName(this.photoshopInfo.appName);
|
|
64
72
|
}
|
|
73
|
+
const executor = this.getExecutor();
|
|
65
74
|
// Check if Photoshop is running, launch if needed
|
|
66
|
-
const isRunning = await
|
|
75
|
+
const isRunning = await executor.isPhotoshopRunning();
|
|
67
76
|
if (!isRunning) {
|
|
68
77
|
this.logger.info('Photoshop not running, launching...');
|
|
69
|
-
await
|
|
78
|
+
await executor.launchPhotoshop(this.photoshopInfo.path);
|
|
70
79
|
}
|
|
71
80
|
// Execute the script
|
|
72
|
-
const result = await
|
|
81
|
+
const result = await executor.execute(script, timeout);
|
|
73
82
|
return result;
|
|
74
83
|
}
|
|
75
84
|
catch (error) {
|
|
@@ -84,10 +93,11 @@ export class PhotoshopConnection {
|
|
|
84
93
|
if (!this.photoshopInfo) {
|
|
85
94
|
this.photoshopInfo = await this.detector.detect();
|
|
86
95
|
}
|
|
87
|
-
const
|
|
96
|
+
const executor = this.getExecutor();
|
|
97
|
+
const isRunning = await executor.isPhotoshopRunning();
|
|
88
98
|
if (!isRunning) {
|
|
89
99
|
this.logger.info('Launching Photoshop...');
|
|
90
|
-
await
|
|
100
|
+
await executor.launchPhotoshop(this.photoshopInfo.path);
|
|
91
101
|
}
|
|
92
102
|
}
|
|
93
103
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/platform/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASpD,MAAM,OAAO,mBAAmB;IACtB,MAAM,CAAS;IACf,QAAQ,CAAoB;IAC5B,QAAQ,
|
|
1
|
+
{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/platform/connection.ts"],"names":[],"mappings":"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"}
|
package/llms.txt
ADDED
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# photoshop-mcp
|
|
2
|
+
|
|
3
|
+
> MCP server for Adobe Photoshop — 1.6.1 — 102 tools (generative AI + recipes), standalone web UI, and state-aware agent workflows. Unofficial; not affiliated with Adobe.
|
|
4
|
+
|
|
5
|
+
**Website:** https://alisaitteke.github.io/photoshop-mcp/
|
|
6
|
+
**llms.txt (site):** https://alisaitteke.github.io/photoshop-mcp/llms.txt
|
|
7
|
+
**llms-full.txt:** https://alisaitteke.github.io/photoshop-mcp/llms-full.txt
|
|
8
|
+
|
|
9
|
+
## Quick start
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
# MCP server (stdio) — use with Cursor, Claude Desktop, Claude Code, VS Code
|
|
13
|
+
npx -y @alisaitteke/photoshop-mcp
|
|
14
|
+
|
|
15
|
+
# Standalone web UI (local chat + Photoshop, no IDE required)
|
|
16
|
+
npx -p @alisaitteke/photoshop-mcp photoshop-mcp-ui
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
**Prerequisites:** Adobe Photoshop (Windows or macOS), Node.js 18+. Photoshop must be running. Optional UXP bridge plugin in `uxp-plugin/` for Neural Filters.
|
|
20
|
+
|
|
21
|
+
## Agent workflow
|
|
22
|
+
|
|
23
|
+
```
|
|
24
|
+
get_capabilities → get_state → (recipe or atomic tool) → get_preview to verify
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Prefer `photoshop_recipe_*` for multi-step outcomes (single undo step). Use atomic `photoshop_*` tools for fine-grained edits. On failure, read structured error envelopes (`code`, `suggested_next_tool`) and call `get_state` before retrying.
|
|
28
|
+
|
|
29
|
+
## MCP client configuration
|
|
30
|
+
|
|
31
|
+
```json
|
|
32
|
+
{
|
|
33
|
+
"mcpServers": {
|
|
34
|
+
"photoshop": {
|
|
35
|
+
"command": "npx",
|
|
36
|
+
"args": ["-y", "@alisaitteke/photoshop-mcp"],
|
|
37
|
+
"env": { "LOG_LEVEL": "1" }
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Claude Code one-liner:
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Tool surface
|
|
50
|
+
|
|
51
|
+
- **102 tools** — 86 atomic + 16 recipe (`photoshop_recipe_*`)
|
|
52
|
+
- **23 MCP prompts** — `ps.remove_background`, `ps.enhance_portrait`, `ps.generative_fill`, …
|
|
53
|
+
- **Generative AI** — fill, remove, expand, upscale, sky replacement, generate image (Adobe account)
|
|
54
|
+
- **State** — `photoshop_get_state`, `photoshop_get_preview`, `photoshop_get_capabilities`
|
|
55
|
+
- **Standalone UI** — Action Plan (beta): plan all steps in one LLM call, then execute
|
|
56
|
+
|
|
57
|
+
## Distribution
|
|
58
|
+
|
|
59
|
+
- npm: `@alisaitteke/photoshop-mcp` (https://www.npmjs.com/package/@alisaitteke/photoshop-mcp)
|
|
60
|
+
- MCP Registry: `io.github.alisaitteke/photoshop-mcp` (https://registry.modelcontextprotocol.io)
|
|
61
|
+
- GitHub: https://github.com/alisaitteke/photoshop-mcp
|
|
62
|
+
|
|
63
|
+
## Documentation (web)
|
|
64
|
+
|
|
65
|
+
- [Home](https://alisaitteke.github.io/photoshop-mcp/)
|
|
66
|
+
- [Full README](https://alisaitteke.github.io/photoshop-mcp/readme/)
|
|
67
|
+
- [Architecture](https://alisaitteke.github.io/photoshop-mcp/docs/architecture/)
|
|
68
|
+
- [Available tools](https://alisaitteke.github.io/photoshop-mcp/docs/available-tools/)
|
|
69
|
+
- [Prompt layer](https://alisaitteke.github.io/photoshop-mcp/docs/prompt-layer/)
|
|
70
|
+
- [Development](https://alisaitteke.github.io/photoshop-mcp/docs/development/)
|
|
71
|
+
- [Troubleshooting](https://alisaitteke.github.io/photoshop-mcp/docs/troubleshooting/)
|
|
72
|
+
- [AGENTS.md](https://github.com/alisaitteke/photoshop-mcp/blob/main/AGENTS.md)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@alisaitteke/photoshop-mcp",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.7.2",
|
|
4
4
|
"description": "MCP server for Adobe Photoshop — 102 tools (generative AI + recipes), standalone web UI. Control Photoshop from Cursor, Claude, or natural language.",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"type": "module",
|
|
@@ -12,8 +12,11 @@
|
|
|
12
12
|
"dist",
|
|
13
13
|
"web/dist",
|
|
14
14
|
"uxp-plugin",
|
|
15
|
+
"examples",
|
|
15
16
|
"README.md",
|
|
16
|
-
"LICENSE"
|
|
17
|
+
"LICENSE",
|
|
18
|
+
"llms.txt",
|
|
19
|
+
"AGENTS.md"
|
|
17
20
|
],
|
|
18
21
|
"scripts": {
|
|
19
22
|
"dev": "tsc --watch",
|
|
@@ -23,6 +26,7 @@
|
|
|
23
26
|
"build": "npm run build:server && npm run build:web",
|
|
24
27
|
"build:server": "tsc",
|
|
25
28
|
"build:web": "npm --prefix web install --no-audit --no-fund && npm --prefix web run build",
|
|
29
|
+
"build:site": "npm --prefix site run build",
|
|
26
30
|
"start": "node dist/index.js",
|
|
27
31
|
"start:ui": "node dist/ui/cli.js",
|
|
28
32
|
"lint": "eslint src --ext .ts",
|
|
@@ -38,6 +42,7 @@
|
|
|
38
42
|
"test:intent-expansion": "tsx scripts/test-intent-expansion-local.ts",
|
|
39
43
|
"prepare": "npm run build",
|
|
40
44
|
"sync:server-version": "tsx scripts/sync-server-version.ts",
|
|
45
|
+
"build:mcpb": "tsx scripts/build-mcpb.ts",
|
|
41
46
|
"prepublishOnly": "npm run build && npm run sync:server-version",
|
|
42
47
|
"test:unit": "vitest run"
|
|
43
48
|
},
|
|
@@ -64,7 +69,7 @@
|
|
|
64
69
|
"type": "git",
|
|
65
70
|
"url": "git+https://github.com/alisaitteke/photoshop-mcp.git"
|
|
66
71
|
},
|
|
67
|
-
"homepage": "https://github.
|
|
72
|
+
"homepage": "https://alisaitteke.github.io/photoshop-mcp/",
|
|
68
73
|
"bugs": {
|
|
69
74
|
"url": "https://github.com/alisaitteke/photoshop-mcp/issues"
|
|
70
75
|
},
|
|
@@ -94,7 +99,7 @@
|
|
|
94
99
|
},
|
|
95
100
|
"mcpName": "io.github.alisaitteke/photoshop-mcp",
|
|
96
101
|
"devDependencies": {
|
|
97
|
-
"@eslint/js": "^
|
|
102
|
+
"@eslint/js": "^9.18.0",
|
|
98
103
|
"@types/better-sqlite3": "^7.6.13",
|
|
99
104
|
"@types/node": "^22.10.5",
|
|
100
105
|
"@typescript-eslint/eslint-plugin": "^8.20.0",
|
package/uxp-plugin/main.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Photoshop MCP UXP Bridge — polls MCP HTTP server and runs batchPlay commands.
|
|
3
|
-
* Load via Adobe UXP Developer Tools (
|
|
3
|
+
* Load via Adobe UXP Developer Tools (Add Plugin → uxp-plugin/manifest.json → Load or Load & Watch from ••• menu).
|
|
4
4
|
*/
|
|
5
5
|
const { entrypoints } = require('uxp');
|
|
6
6
|
const photoshop = require('photoshop');
|
package/uxp-plugin/manifest.json
CHANGED
|
@@ -2,14 +2,15 @@
|
|
|
2
2
|
"id": "com.photoshop-mcp.uxp-bridge",
|
|
3
3
|
"name": "Photoshop MCP UXP Bridge",
|
|
4
4
|
"version": "1.0.0",
|
|
5
|
-
"
|
|
5
|
+
"manifestVersion": 4,
|
|
6
|
+
"main": "index.html",
|
|
6
7
|
"host": {
|
|
7
8
|
"app": "PS",
|
|
8
9
|
"minVersion": "24.0.0"
|
|
9
10
|
},
|
|
10
11
|
"requiredPermissions": {
|
|
11
12
|
"network": {
|
|
12
|
-
"domains": ["127.0.0.1", "localhost"]
|
|
13
|
+
"domains": ["http://127.0.0.1:38452", "http://localhost:38452"]
|
|
13
14
|
},
|
|
14
15
|
"localFileSystem": "request"
|
|
15
16
|
},
|