@appscreenshotstudio/mcp 0.2.0 → 0.2.1
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 +53 -5
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -44,9 +44,15 @@ Add to your MCP config (`.cursor/mcp.json`, `settings.json`, etc.):
|
|
|
44
44
|
|
|
45
45
|
## Tools
|
|
46
46
|
|
|
47
|
+
### `prepare-screenshot-brief`
|
|
48
|
+
|
|
49
|
+
Get a research checklist and strategy guide before generating. Returns file patterns to search for across tech stacks, story flow recommendations per app category, headline tips, and the `codebase_context` schema to fill in.
|
|
50
|
+
|
|
51
|
+
**Free — no API call or credits.**
|
|
52
|
+
|
|
47
53
|
### `generate-screenshots`
|
|
48
54
|
|
|
49
|
-
Create a complete set of App Store screenshots.
|
|
55
|
+
Create a complete set of App Store screenshots. The agent researches your codebase first, then passes rich context for accurate, app-specific designs.
|
|
50
56
|
|
|
51
57
|
| Parameter | Type | Required | Description |
|
|
52
58
|
|---|---|---|---|
|
|
@@ -58,9 +64,27 @@ Create a complete set of App Store screenshots. One tool call = one full project
|
|
|
58
64
|
| `device_id` | string | No | Target device (default: `iphone-6.9`) |
|
|
59
65
|
| `count` | number | No | Number of cards, 3-10 (default: 5) |
|
|
60
66
|
| `story_flow` | string | No | Narrative structure (default: `auto`) |
|
|
67
|
+
| `codebase_context` | object | No | App context from codebase research (see below) |
|
|
61
68
|
|
|
62
69
|
**Costs 5 credits.**
|
|
63
70
|
|
|
71
|
+
#### `codebase_context`
|
|
72
|
+
|
|
73
|
+
Pass this for dramatically better screenshots. The context is persisted on the project and used in all subsequent chats.
|
|
74
|
+
|
|
75
|
+
| Field | Description |
|
|
76
|
+
|---|---|
|
|
77
|
+
| `readme_summary` | App overview from README or docs |
|
|
78
|
+
| `key_screens` | Main screens/views (e.g. "Dashboard", "Settings") |
|
|
79
|
+
| `color_tokens` | Brand colors from theme files (e.g. `{ "primary": "#7C3AED" }`) |
|
|
80
|
+
| `target_audience` | Who the app is for |
|
|
81
|
+
| `app_category` | fitness, finance, social, productivity, etc. |
|
|
82
|
+
| `competitive_edge` | What makes it unique |
|
|
83
|
+
| `app_store_description` | Existing store listing if found |
|
|
84
|
+
| `tech_stack` | React Native, SwiftUI, Flutter, etc. |
|
|
85
|
+
| `ui_style` | "dark mode with neon accents", "clean minimal", etc. |
|
|
86
|
+
| `primary_user_flow` | Main user journey through the app |
|
|
87
|
+
|
|
64
88
|
### `edit-screenshots`
|
|
65
89
|
|
|
66
90
|
Make changes to an existing project with natural language. Optionally target specific cards.
|
|
@@ -70,6 +94,7 @@ Make changes to an existing project with natural language. Optionally target spe
|
|
|
70
94
|
| `project_id` | string | Yes | From a previous `generate-screenshots` call |
|
|
71
95
|
| `message` | string | Yes | What to change |
|
|
72
96
|
| `card_indices` | number[] | No | Target specific cards by index (0-based). Omit to edit all. |
|
|
97
|
+
| `codebase_context` | object | No | App context to enrich the edit (same schema as above) |
|
|
73
98
|
|
|
74
99
|
**Costs 5 credits.**
|
|
75
100
|
|
|
@@ -111,6 +136,28 @@ Show all supported device specs. No API call needed.
|
|
|
111
136
|
|
|
112
137
|
**Free.**
|
|
113
138
|
|
|
139
|
+
## Prompts
|
|
140
|
+
|
|
141
|
+
MCP prompts are pre-defined workflows your agent can follow.
|
|
142
|
+
|
|
143
|
+
### `create-app-screenshots`
|
|
144
|
+
|
|
145
|
+
Full guided workflow: research the codebase, generate screenshots with rich context, iterate, and export. Best results when used from within the app's project directory.
|
|
146
|
+
|
|
147
|
+
| Argument | Default | Description |
|
|
148
|
+
|---|---|---|
|
|
149
|
+
| `platform` | ios | "ios", "android", or "both" |
|
|
150
|
+
| `extra_instructions` | none | Additional instructions like "use dark theme" |
|
|
151
|
+
|
|
152
|
+
### `improve-screenshots`
|
|
153
|
+
|
|
154
|
+
Research the codebase and improve an existing screenshot project. Compares current designs to the actual app and makes targeted fixes.
|
|
155
|
+
|
|
156
|
+
| Argument | Required | Description |
|
|
157
|
+
|---|---|---|
|
|
158
|
+
| `project_id` | Yes | Project ID to improve |
|
|
159
|
+
| `focus` | No | What to focus on: "headlines", "colors", "story flow", etc. |
|
|
160
|
+
|
|
114
161
|
## Supported Devices
|
|
115
162
|
|
|
116
163
|
| ID | Name | Size | Required |
|
|
@@ -133,10 +180,11 @@ The AI generates professional screenshots using:
|
|
|
133
180
|
|
|
134
181
|
## Workflow
|
|
135
182
|
|
|
136
|
-
1. **
|
|
137
|
-
2. **
|
|
138
|
-
3. **
|
|
139
|
-
4. **
|
|
183
|
+
1. **Research** — Agent calls `prepare-screenshot-brief`, then searches your codebase for app name, features, colors, screens, and audience
|
|
184
|
+
2. **Generate** — Agent calls `generate-screenshots` with `codebase_context` for app-specific designs
|
|
185
|
+
3. **Iterate** — Agent calls `edit-screenshots` to refine (codebase context carries over automatically)
|
|
186
|
+
4. **Upload** — Open the project URL, upload your actual app screenshots into the device mockups
|
|
187
|
+
5. **Export** — Agent calls `render-screenshots` or click "Download All" in the web app
|
|
140
188
|
|
|
141
189
|
## Security
|
|
142
190
|
|