expo-assets-mcp
Generates and transforms Expo assets such as icons, splash screens, and favicons for Expo projects.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@expo-assets-mcp Generate Expo icons from ~/logo.png"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
expo-assets-mcp
Local MCP server to generate and transform Expo assets. Also includes a CLI script to run it directly from the terminal.
Project structure
src/
├── expo-assets.ts ← reusable logic (asset definitions, image transformations)
├── index.ts ← MCP server
└── generate.ts ← CLI script
dist/ ← compiled output (generated with npm run build)Related MCP server: SVG Maker MCP Server
Installation
npm install
npm run buildWeb Generator
A pure JavaScript version of this tool is available directly in the browser! Open index.html or visit https://elber-code.github.io/expo-assets-mcp/ to access a rich GUI that features:
Interactive Cropper: Perfectly center your icons with a 1:1 aspect ratio.
Live Icon Previews: See how your icon looks in iOS (squircle) and Android (circle) shapes with transparent or solid backgrounds in real-time.
Advanced Banners: Generate App Store mockups or promo banners by placing your Expo assets (e.g. Splash, Icon) inside custom resolutions to download individually.
Custom ZIP Assets: Easily add extra custom-sized assets to the final ZIP.
Bilingual Interface: Seamlessly switch between English and Spanish (
index_es.html).
No backend or server required; everything is processed locally in your browser!
CLI usage
Generates all Expo assets from a source image. Creates a folder next to the image named <image>-assets/.
node dist/generate.js <image-path> [options]Options:
Flag | Description |
| Background color. Omit for transparent |
| Skip files that already exist |
Examples:
# Transparent background
node dist/generate.js /Users/me/logo.png
# With background color
node dist/generate.js /Users/me/logo.png --bg "#E6F4FE"Output:
/Users/me/logo-assets/
├── icon.png
├── android-icon-foreground.png
├── android-icon-background.png
├── android-icon-monochrome.png
├── splash-icon.png
├── favicon.png
├── react-logo.png
├── react-logo@2x.png
├── react-logo@3x.png
└── partial-react-logo.pngMCP usage (Claude Desktop)
Copy claude-config.example.json to claude-config.json, fill in the correct path, then merge it into:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"expo-assets-mcp": {
"command": "node",
"args": ["/absolute/path/to/expo-assets-mcp/dist/index.js"]
}
}
}Test with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.jsAvailable MCP tools
generate_expo_icons
Generates all 10 Expo assets into a single assets/images/ folder.
Parameter | Type | Default | Description |
| string | — | Absolute path to the source image |
| string | — | Absolute path to the Expo project's |
| string | transparent | Background color in hex (e.g. |
| boolean |
| Overwrite existing files |
| object | see table | Content proportion per asset (0.1–1.0) |
Proportions:
Key | Asset(s) | Default |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
transform_image
Transforms an image to specific dimensions with optional content proportion and background.
Parameter | Type | Default | Description |
| string | — | Path to the source image (PNG, JPEG, WebP, TIFF, AVIF) |
| string | — | Full output path including filename and extension (e.g. |
| number | — | Output canvas width in pixels |
| number | — | Output canvas height in pixels |
| number |
| How much of the canvas the content fills (0.1–1.0, 1 = fills everything) |
| string | transparent | Canvas background color in hex. Omit for transparent. |
|
|
| Output file format |
| number |
| Compression quality for jpeg/webp only (1 = lowest, 100 = highest) |
convert_svg
Converts an SVG file to PNG, JPEG, or WebP at the specified dimensions.
Parameter | Type | Default | Description |
| string | — | Absolute path to the source SVG file |
| string | — | Full output path including filename and extension |
| number | — | Output width in pixels |
| number | proportional | Output height in pixels. Omit to scale proportionally from width. |
|
|
| Output file format |
| string | transparent | Background color in hex. Omit for transparent (PNG only). |
| number |
| Compression quality for jpeg/webp only (1 = lowest, 100 = highest) |
Generated assets
Expo handles all platform-specific resizing automatically from these 10 files.
Source image requirements
Format: PNG
Minimum size: 1024×1024 px
Background: transparent (recommended)
Asset table
File | Canvas | Background | Transformation | app.json key |
| 1024×1024 |
|
|
|
| 512×512 | Always transparent |
|
|
| 512×512 |
|
|
|
| 432×432 | Always transparent | White silhouette, prop 0.33 |
|
| 1024×1024 | Always transparent |
|
|
| 48×48 | Always transparent |
|
|
| 100×100 | Always transparent |
| Decorative UI @1x |
| 200×200 | Always transparent |
| Decorative UI @2x |
| 300×300 | Always transparent |
| Decorative UI @3x |
| 518×316 | Always transparent | Right-side crop from top, prop 0.5 | Decorative UI partial |
Special transformations
android-icon-monochrome.png — White silhouette
Every non-transparent pixel is converted to pure white. Android 13+ uses this for Themed Icons, tinting the silhouette with the system color theme.
pixel (r, g, b, a > 10) → (255, 255, 255, a)
pixel (r, g, b, a ≤ 10) → unchanged (transparent)partial-react-logo.png — Section crop
A section of the source image is cropped without distortion:
Horizontal: right side (end)
Vertical: from the top (start)
The section is scaled proportionally to fit the 518×316 canvas
partial_logo: 0.5 → right half · partial_logo: 0.33 → right third
Android adaptive icon — Safe zone
Keep important content within the 66% center (338×338 px on a 512×512 canvas) to avoid being clipped by any Android launcher shape.
┌─────────────────┐ 512×512
│ │
│ ┌───────────┐ │
│ │ safe │ │ 338×338 (66%)
│ │ zone │ │
│ └───────────┘ │
│ │
└─────────────────┘Scripts
npm run build # compile TypeScript
npm start # start MCP server
npm run dev # run with tsx (no compile needed)Available Tools
3 toolsconvert_svgB
Converts an SVG file to PNG, JPEG, or WebP at the specified dimensions. Supports multiple output sizes in a single call.
Inputs: width (required), input_svg (required), output_path (required), format, +3 more.
generate_expo_iconsA
Generates all 10 Expo assets into assets/images/: icon, android adaptive (foreground/background/monochrome), splash, favicon, react-logo (@1x/@2x/@3x) and partial.
Inputs: output_dir (required), input_image (required), overwrite, proportions, +1 more.
transform_imageB
Transforms an image to the specified canvas dimensions with optional content proportion and background color.
Inputs: width (required), height (required), input_image (required), output_path (required), +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: generate_expo_icons creates a predefined set of Expo assets, transform_image modifies an existing image's canvas, and convert_svg handles SVG to raster conversion. There is no overlap or ambiguity between them.
All tool names follow a consistent verb_noun pattern using snake_case: generate_expo_icons, transform_image, convert_svg. This provides a predictable and readable naming convention throughout the server.
With only 3 tools, the server is well-scoped for its specific purpose of handling Expo assets. Each tool is essential and non-redundant, fitting within the ideal range without feeling thin or excessive.
The tool surface covers the full lifecycle of asset preparation: generating standard Expo icons, transforming existing images, and converting SVGs to required formats. No obvious gaps exist for the stated purpose, as the set includes both batch generation and bespoke manipulation utilities.
Maintenance
Related MCP Connectors
Generate PWA icon sets and iOS splash screens from a text prompt or an existing image.
Visual builder for React Native and Expo apps. Read and update project design tokens.
Generate and vectorize clean, editable SVG graphics from text, images, or both.
Manage over-the-air (OTA) updates for React Native, Expo, Capacitor and Cordova apps.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceEnables programmatic interaction with Expo/React Native projects and EAS (Expo Application Services) for managing builds, publishing OTA updates, submitting apps to stores, and accessing comprehensive documentation.6MIT
- AlicenseNot gradedqualityDmaintenanceEnables creation, validation, rendering, and optimization of SVG images with conversion capabilities to PNG, React components, React Native components, and Data URIs.ISC
- AlicenseNot gradedqualityCmaintenanceGenerates all required web app icons and manifest files from a single source image with framework auto-detection. Supports Next.js App Router, traditional web apps, and PWA standards with zero configuration.15 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to execute Expo and EAS operations including project setup, cloud builds, OTA updates, app submission, and diagnostics.MIT