使用说明
MUSE App Preview MCP
MCP (Model Context Protocol) server for managing App Store preview screenshots. Claude can automatically capture simulator screenshots, generate marketing text, and create beautiful preview images.
Features
| Tool | Description |
|---|---|
create_app_previews |
Complete workflow: pick platform/language, generate marketing text, auto-capture, send to MUSE Preview Maker |
capture_simulator |
Capture a screenshot from the running iOS Simulator and add it as a preview set |
list_simulators |
List all booted iOS Simulators that can be captured |
launch_and_capture |
Launch an app on the simulator and capture a screenshot |
capture_app_screens |
Capture multiple screens from a running app |
interact_simulator |
Interact with the simulator: tap, swipe, scroll, type text |
navigate_app |
Navigate to a screen via deep links / URL schemes |
configure_simulator |
Configure status bar time, battery, signal, dark/light mode |
auto_capture_flow |
Automatically capture a user flow with actions |
scroll_and_capture |
Scroll through a screen and capture at intervals |
batch_capture_devices |
Capture the same screen on multiple devices/simulators |
record_and_extract |
Record simulator video and extract key frames as screenshots |
add_preview |
Add a screenshot with title and subtitle as a preview set |
list_previews |
List all saved preview sets |
remove_preview |
Remove a specific preview by ID |
update_preview |
Update an existing preview set |
clear_all |
Clear all saved previews |
reset_all |
Complete reset: previews, screenshots, and pending data |
open_app |
Open MUSE Preview Maker app |
generate_previews |
Generate all preview images at once |
get_settings |
Get current default settings |
update_settings |
Update default device type, palette, output directory |
Installation
Using Claude Code
claude mcp add muse-app-preview-mcp npx muse-app-preview-mcp
Global Installation
npm install -g muse-app-preview-mcp
Automated Workflow
Just say to Claude:
"Create App Store previews for my app"
Claude will automatically:
- Analyze your conversation to identify key features
- Capture screenshots from the running iOS Simulator
- Generate marketing titles and subtitles
- Create beautiful App Store preview images
┌─────────────────────────────────────────────────────────────┐
│ Fully Automated Preview Generation │
│ │
│ User: "Create App Store previews" │
│ │
│ Claude: │
│ 1. Analyzes conversation → "Login, Dashboard, Settings" │
│ 2. Generates marketing text: │
│ ├── "Easy Login" / "Get started in seconds" │
│ ├── "Smart Dashboard" / "Everything at a glance" │
│ └── "Custom Settings" / "Make it yours" │
│ 3. Captures each screen from Simulator │
│ 4. Sends to MUSE Preview Maker │
│ 5. Generates all preview images! │
└─────────────────────────────────────────────────────────────┘
Manual Usage
1. Capture from Simulator
With your app running in iOS Simulator:
capture_simulator:
title: "Amazing Feature"
subtitle: "Discover new possibilities"
2. Add Preview from File
add_preview:
screenshotPath: "/path/to/screenshot.png"
title: "Amazing Feature"
subtitle: "Discover new possibilities"
deviceId: "iphone_6.7" # optional
paletteId: "ocean" # optional
3. Generate All Previews
generate_previews:
outputDirectory: "/path/to/output" # optional
exportAllSizes: true # optional
Supported Devices
Device ids accepted by deviceId (matching MUSE Preview Maker 1.1.1). The classic underscore ids (iphone_6_7, ipad_12_9, ...) are still accepted and translated automatically.
| Device | deviceId |
Size |
|---|---|---|
| iPhone 6.9" (17 Pro Max) | iphone_6.9 |
1320 x 2868 |
| iPhone 6.7" (15 Pro Max) | iphone_6.7 |
1290 x 2796 |
| iPhone Air 6.5" | iphone_air_6.5 |
1260 x 2736 |
| iPhone 6.5" (14 Plus) | iphone_6.5 |
1284 x 2778 |
| iPhone 6.3" (17 Pro) | iphone_6.3 |
1206 x 2622 |
| iPhone 6.1" (16) | iphone_6.1 |
1179 x 2556 |
| iPhone 5.5" (8 Plus) | iphone_5.5 |
1242 x 2208 |
| iPad Pro 13" M4 | ipad_13_m4 |
2064 x 2752 |
| iPad Pro 12.9" | ipad_12.9 |
2048 x 2732 |
| iPad Air / Pro 11" | ipad_11 |
1668 x 2388 |
| iPad 10.9" | ipad_10.9 |
1640 x 2360 |
| Mac App Store | mac_standard |
1280 x 800 |
| Mac App Store (Retina) | mac_retina |
2880 x 1800 |
| Apple Watch Ultra 49mm | watch_ultra_49mm |
410 x 502 |
| Apple Watch 46mm (S10) | watch_series10_46mm |
416 x 496 |
| Apple Watch 45mm | watch_45mm |
396 x 484 |
| Apple Watch 42mm (S10) | watch_series10_42mm |
374 x 446 |
| Apple Watch 41mm (SE) | watch_41mm |
352 x 430 |
| Apple Vision Pro | visionpro |
3840 x 2160 |
| Apple TV | appletv_4k / appletv_4k_uhd |
1920 x 1080 / 3840 x 2160 |
| Android Phone | android_phone |
1080 x 1920 |
| Android Tablet | android_tablet |
1200 x 1920 |
instagram_2_3 / instagram_4_5 / instagram_1_1 / instagram_story |
2:3 / 4:5 / 1:1 / story |
Color Palettes
Palette ids accepted by paletteId (MUSE Preview Maker 1.1.1):
ocean · azure · midnight · sunset · coral · peach · forest · mint · purple · lavender · galaxy · dark · charcoal · light · cream · neon · aurora
Requirements
- Node.js 18+
- Xcode Command Line Tools (for simulator capture)
- MUSE Preview Maker app 1.1.1+ (macOS) - for image generation (older versions work, but the full device table above requires 1.1+)
Related
- MUSE Preview Maker - macOS app for creating App Store preview images (v1.1.1)
License
MIT
