
Icon Composer Mcp
io.github.ethbakPublished by GitHub account ethbakv1.1.0Updated Oct 24, 2026
CLI and MCP server for creating Apple .icon bundles with Liquid Glass effects (iOS 26+)
Overview
Creates and edits Apple .icon bundles with Liquid Glass effects, exporting preview and App Store marketing icons.
- What you can do
- Provides 12 MCP tools and 3 guided prompts for building Apple .icon bundles from PNG or SVG glyphs. Tools create bundles, add or remove layers and groups, set background fills, configure Liquid Glass effects such as specular, blur, shadow and translucency, and define dark or tinted appearance overrides. It can export preview PNGs, render pixel-perfect Liquid Glass through Apple's ictool, and export flat 1024x1024 marketing icons for App Store Connect.
- When to use it
- Useful when an assistant needs to generate or iterate on iOS 26+ app icons, logos, or branded icon sets, including dark mode variants and App Store marketing assets. Best for macOS users who want Liquid Glass rendering; flat previews and bundle editing also work elsewhere.
- Requirements
- Runs locally over stdio via npx icon-composer-mcp, requiring Node.js 18+. Liquid Glass rendering needs macOS with Apple's Icon Composer.app installed; flat previews, bundle creation and editing, and marketing export work on any platform. No accounts, API keys, or environment variables are declared.
Installation
In SourceWeft
- Open Icon Composer Mcp in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
Icon Composer MCP
CLI and MCP server for creating images, icons, and logos with Liquid Glass effects (iOS 26+). Not affiliated with Apple .
[npm version] [license] [platform] [MCP compatible] [Glama score]
Demo
Key Features
- Create
.iconbundles programmatically from PNG or SVG glyphs - Full Liquid Glass support: specular highlights, blur material, shadows, translucency
- Dark mode + appearance variants with per-appearance fill specializations
- AI-agent ready: 12 MCP tools + 3 workflow prompts with built-in instructions
Installation
[Image] Claude Code
[Image] Cursor
Add to .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global):
The server will appear in Cursor Settings > MCP Servers. No restart required.
[Image] VS Code
Add to .vscode/mcp.json in your project root (or open Command Palette > MCP: Open User Configuration for global):
Note: VS Code uses
"servers"(not"mcpServers") and requires a"type"field.
You'll see Start/Stop/Restart buttons inline in the editor. First launch will prompt a trust confirmation.
[Image] Windsurf
First, enable MCP in Windsurf Settings > Cascade > Model Context Protocol (MCP).
Then add to ~/.codeium/windsurf/mcp_config.json:
Press the refresh button in Windsurf settings to load the server.
Other MCP clients
The server uses stdio transport. Most MCP clients use this config format:
Or run the server directly:
CLI only (no MCP)
How It Works
- Provide a glyph — any PNG or SVG logo/image
- Create a
.iconbundle — sets background fill, layer scale, and glass effects - Apple's ictool renders Liquid Glass — specular highlights, shadows, depth, and translucency
- Export — preview PNGs, App Store marketing icon, or the
.iconbundle for Xcode
Requirements
- Node.js 18+
- macOS with Icon Composer for Liquid Glass rendering
- Flat previews, bundle creation/editing, and marketing export work on any platform without Icon Composer
Run icon-composer doctor to check your setup.
CLI Commands
Details
create — Create a new .icon bundle
Output: Creates <output_dir>/<bundle_name>.icon/ containing icon.json manifest and Assets/ directory.
add-layer — Add a layer to an existing bundle
Supported formats: .png, .jpg, .jpeg, .svg, .webp, .heic, .heif
remove — Remove a layer or group
inspect — Read and display bundle contents
Output: Prints the full manifest JSON and lists all assets with sizes.
glass — Configure Liquid Glass effects
appearance — Set dark/tinted mode overrides
fill — Set background fill
position — Set layer/group scale and offset
fx — Toggle all glass effects
Enables or disables specular, shadow, blur, and translucency on every group at once.
preview — Export a preview PNG
Output: PNG file. Uses Liquid Glass rendering by default (falls back to flat if Icon Composer is not installed).
render — Render Liquid Glass via ictool
Requires: Icon Composer.app installed. Returns an error with install instructions if missing.
export-marketing — Export for App Store Connect
Output: Flat PNG with no alpha channel (avoids ITMS-90717 rejection). Default 1024x1024.
doctor — Check system setup
Output: Reports Node version, platform, ictool path and version. Prints install instructions if Icon Composer is missing.
MCP Tools
All tools return { content: [{ type: "text", text: "..." }], isError?: true }.
Details
create_icon
Create a .icon bundle from a foreground image.
add_layer_to_icon
add_layer_to_icon
Add a layer to an existing bundle.
remove_layer
remove_layer
Remove a layer or group. layer_index required when target=layer.
read_icon
read_icon
Inspect a bundle. Returns full manifest JSON and asset list with sizes.
set_glass_effects
set_glass_effects
Configure Liquid Glass on a group. All effect parameters are optional — only provided values are changed.
set_appearances
set_appearances
Set dark/tinted overrides for background fill, group effects, or individual layer properties.
set_fill
set_fill
Set background fill.
set_layer_position
set_layer_position
Adjust layer or group scale and offset.
toggle_fx
toggle_fx
Enable or disable all glass effects on every group.
export_preview
export_preview
Render a preview PNG. Uses Liquid Glass by default, falls back to flat.
render_liquid_glass
render_liquid_glass
Pixel-perfect Liquid Glass via Apple's ictool. Requires Icon Composer.app.
export_marketing
export_marketing
Flat marketing PNG for App Store Connect. No glass effects, no alpha channel.
MCP Prompts
Example Workflows
Create a branded icon
Export for App Store
Multi-layer icon with glass
Limitations
- Liquid Glass rendering requires macOS with Apple's Icon Composer.app installed. Flat rendering works everywhere.
- ClearLight/ClearDark renditions render against gray. Apple's glass transparency requires Metal GPU, not available via CLI.
Architecture
Contributing
Source: README.md at commit e7d2b32
Tools
0Version history
1- v1.1.0LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts