Icon Composer MCP server

by ethbak·io.github.ethbak/icon-composer-mcp·v1.1.0·53 stars

No reviews yet

CLI and MCP server for creating Apple .icon bundles with Liquid Glass effects (iOS 26+)

B82/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B82/100

full report

Adoption

Growing

53 stars

Reviews

Write one

Nobody has reviewed Icon Composer yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Icon Composer tools (12, 2 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

add_layer_to_icon
Add a new layer to an existing .icon bundle. Creates a new group or adds to an existing one.
create_iconwrite action
Create an Apple Icon Composer .icon bundle from a foreground image and background color. Outputs a ready-to-use .icon bundle for Xcode 26.
export_marketing
Export a flat marketing PNG for App Store Connect. No Liquid Glass effects, no alpha channel. Produces a 1024x1024 (default) opaque PNG ready for upload.
export_preview
Render a preview of an .icon bundle. Uses Apple's ictool for Liquid Glass rendering by default (falls back to flat composite if Icon Composer is not installed). Supports canvas backgrounds and zoom.
read_icon
Read and inspect an existing .icon bundle. Returns the manifest JSON and list of assets.
remove_layerwrite action
Remove a layer or entire group from an .icon bundle. Optionally cleans up orphaned asset files.
render_liquid_glass
Render a pixel-perfect Liquid Glass preview using Apple's ictool. Produces the exact same rendering as iOS 26. Requires Icon Composer.app installed.
set_appearances
Set dark mode or tinted mode appearance overrides for the icon background fill, layer group, or individual layer properties.
set_fill
Set the background fill of an .icon bundle. Supports solid colors and gradients.
set_glass_effects
Configure Liquid Glass effects (specular, blur, shadow, translucency) on a layer group in an existing .icon bundle.
set_layer_position
Set the scale (zoom) and offset of a layer or group within the .icon bundle. Use to zoom the glyph in/out or reposition it.
toggle_fx
Enable or disable all Liquid Glass effects (specular, shadow, blur, translucency) on every group in the .icon bundle at once.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan6 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 174 days ago8/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Icon Composer compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 82/100; higher than 63% of 48,255 servers
Tools: 12; the typical server has 7
Tools that change things: 17%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 53; more than 94% of 28,688 servers

What its tools let an agent do: 4 read · 2 create · 5 change · 1 delete

Install Icon Composer in Claude Code, Cursor or VS Code

Runs npx -y icon-composer-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add icon-composer-mcp -- npx -y icon-composer-mcp

Add to Cursor

What the publisher says

From the Icon Composer repository's README, as published. We do not edit it. Read it on GitHub

Icon Composer MCP

CLI and MCP server for creating images, icons, and logos with Liquid Glass effects (iOS 26+). Not affiliated with Apple .

Demo

Key Features

Create .icon bundles 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

   Claude Code

claude mcp add icon-composer -- npx -y icon-composer-mcp

   Claude Desktop

Add to ~/Library/Application Support/Claude/claudedesktopconfig.json:

{
  "mcpServers": {
    "icon-composer": {
      "command": "npx",
      "args": ["-y", "icon-composer-mcp"]
    }
  }
}

   Cursor

Add to .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "icon-composer": {
      "command": "npx",
      "args": ["-y", "icon-composer-mcp"]
    }
  }
}

The server will appear in Cursor Settings > MCP Servers. No restart required.

   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.

{
  "servers": {
    "icon-composer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "icon-composer-mcp"]
    }
  }
}

You'll see Start/Stop/Restart buttons inline in the editor. First launch will prompt a trust confirmation.

   Windsurf

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Icon Composer: common questions

Is Icon Composer MCP server safe?: Mostly: it is graded B (82/100). Read the Icon Composer safety report
How do I install Icon Composer?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Icon Composer need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Icon Composer maintained?: The last commit was 212 days ago (2026-04-06). The latest release is v1.1.0.
How does Icon Composer compare with other MCP servers?: safety score 82/100 (higher than 63% of 48,255 servers); tools 12 (the typical server has 7); tools that change things 17% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.