# icon-composer-mcp

Generates Apple .icon asset bundles with Liquid Glass styling from SVG and PNG inputs. Helps mobile developers prepare application icons and App Store graphics directly through AI agents.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 62
- Author: ethbak
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ethbak/icon-composer-mcp
- Updated: 2026-10-03
- HTML: https://affpapa.org/en/nevibecode/mcp/icon-composer-mcp

## What it does

The server gives AI agents 12 tools and 3 structured workflow prompts to handle application icons. It accepts SVG or PNG inputs to assemble `.icon` bundles for Xcode projects, configuring layer scale, background fills, and positioning. It also handles Liquid Glass properties such as specular highlights, material blur, translucency, and shadows, alongside appearance overrides for dark mode.

Packaging bundles and exporting flat 1024x1024 marketing graphics work across platforms with Node.js 18+. Full glass rendering requires macOS with Apple's Icon Composer installed via Homebrew. Without the native ictool utility, pixel-perfect Liquid Glass rendering will not execute.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add icon-composer-mcp -- npx -y icon-composer-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add icon-composer-mcp -- npx -y icon-composer-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "icon-composer-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "icon-composer-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "icon-composer-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "icon-composer-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add icon-composer-mcp npx -y icon-composer-mcp
```

## When to use it
- generate `.icon` asset bundles from SVG or PNG glyphs
- configure Liquid Glass material blur, shadows, and highlights
- set up custom appearance overrides for dark mode icons
- export 1024x1024 flat PNG assets for App Store Connect submission

## Example prompts
- Create a new `.icon` bundle using `logo.svg` with background color `#0A66C2`
- Adjust Liquid Glass translucency and specular highlights on the main layer
- Export a 1024x1024 marketing PNG without alpha transparency for App Store Connect

## Similar
- [Next AI Draw.io](https://affpapa.org/en/nevibecode/mcp/next-ai-drawio.md) — MCP server · ★ 36398
- [tldraw](https://affpapa.org/en/nevibecode/mcp/tldraw.md) — MCP server · ★ 51091
- [Figma-Context-MCP](https://affpapa.org/en/nevibecode/mcp/figma-context-mcp.md) — MCP server · ★ 16062
- [Agent-Native Assets](https://affpapa.org/en/nevibecode/mcp/agent-native-assets.md) — MCP server · ★ 7506
- [Remove AI Watermarks](https://affpapa.org/en/nevibecode/mcp/remove-ai-watermarks.md) — MCP server · ★ 6114
- [Dembrandt](https://affpapa.org/en/nevibecode/mcp/dembrandt.md) — MCP server · ★ 3821

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md