Demo
Key Features
- Create
.iconbundles programmatically from PNG or SVG glyphs - Full Liquid Glass support: specular highlights, blur material, shadows, translucency
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y [email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
claude mcp add icon-composer-mcp -- npx -y icon-composer-mcp@1.1.1在終端機中執行。
{ "mcpServers": { "icon-composer-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
.icon bundles programmatically from PNG or SVG glyphsCLI and MCP server for creating Apple .icon bundles with Liquid Glass effects (iOS 26+)
claude mcp add icon-composer -- npx -y icon-composer-mcp
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"icon-composer": {
"command": "npx",
"args": ["-y", "icon-composer-mcp"]
}
}
}
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.
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.
First, enable MCP in Windsurf Settings > Cascade > Model Context Protocol (MCP).
Then add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"icon-composer": {
"command": "npx",
"args": ["-y", "icon-composer-mcp"]
}
}
}
Press the refresh button in Windsurf settings to load the server.
The server uses stdio transport. Most MCP clients use this config format:
{
"mcpServers": {
"icon-composer": {
"command": "npx",
"args": ["-y", "icon-composer-mcp"]
}
}
}
Or run the server directly:
npx -y icon-composer-mcp
npm install -g icon-composer-mcp
icon-composer --help
.icon bundle — sets background fill, layer scale, and glass effects.icon bundle for Xcodebrew install --cask icon-composer
Run icon-composer doctor to check your setup.
icon-composer create <foreground_path> <output_dir> --bg-color <hex> [options]
Output: Creates <output_dir>/<bundle_name>.icon/ containing icon.json manifest and Assets/ directory.
icon-composer add-layer <bundle_path> <image_path> --name <name> [options]
Supported formats: .png, .jpg, .jpeg, .svg, .webp, .heic, .heif
icon-composer remove <bundle_path> --target <layer|group> --group-index <n> [--layer-index <n>]
icon-composer inspect <bundle_path>
Output: Prints the full manifest JSON and lists all assets with sizes.
icon-composer glass <bundle_path> [options]
icon-composer appearance <bundle_path> --target <fill|group|layer> --appearance <dark|tinted> [options]
icon-composer fill <bundle_path> --type <solid|gradient|automatic|none> [options]
icon-composer position <bundle_path> [options]
icon-composer fx <bundle_path> --enable|--disable
Enables or disables specular, shadow, blur, and translucency on every group at once.
icon-composer preview <bundle_path> <output_path> [options]
Output: PNG file. Uses Liquid Glass rendering by default (falls back to flat if Icon Composer is not installed).
icon-composer render <bundle_path> <output_path> [options]
Requires: Icon Composer.app installed. Returns an error with install instructions if missing.
icon-composer export-marketing <bundle_path> <output_path> [--size <n>]
Output: Flat PNG with no alpha channel (avoids ITMS-90717 rejection). Default 1024x1024.
icon-composer doctor
Output: Reports Node version, platform, ictool path and version. Prints install instructions if Icon Composer is missing.
All tools return { content: [{ type: "text", text: "..." }], isError?: true }.
Create a .icon bundle from a foreground image.
add_layer_to_iconAdd a layer to an existing bundle.
remove_layerRemove a layer or group. layer_index required when target=layer.
read_iconInspect a bundle. Returns full manifest JSON and asset list with sizes.
set_glass_effectsConfigure Liquid Glass on a group. All effect parameters are optional — only provided values are changed.
set_appearancesSet dark/tinted overrides for background fill, group effects, or individual layer properties.
set_fillSet background fill.
set_layer_positionAdjust layer or group scale and offset.
toggle_fxEnable or disable all glass effects on every group.
export_previewRender a preview PNG. Uses Liquid Glass by default, falls back to flat.
render_liquid_glassPixel-perfect Liquid Glass via Apple's ictool. Requires Icon Composer.app.
export_marketingFlat marketing PNG for App Store Connect. No glass effects, no alpha channel.
# Create with brand color
icon-composer create logo.svg ./out --bg-color "#0A66C2"
# Add dark mode
icon-composer appearance ./out/AppIcon.icon --target fill --appearance dark --bg-color "#0D1B2A"
# Configure glass effects
icon-composer glass ./out/AppIcon.icon --specular --shadow-kind layer-color --blur-material 0.3
# Preview
icon-composer preview ./out/AppIcon.icon preview.png
# Marketing icon (flat, no alpha, 1024x1024)
icon-composer export-marketing ./out/AppIcon.icon marketing.png
# The .icon bundle goes into your Xcode project's asset catalog
# Create base icon
icon-composer create background.svg ./out --bg-color "#1C1C2E"
# Add foreground layers
icon-composer add-layer ./out/AppIcon.icon glyph.svg --name glyph --opacity 0.8
icon-composer add-layer ./out/AppIcon.icon badge.svg --name badge --create-group
# Configure glass per group
icon-composer glass ./out/AppIcon.icon --group-index 0 --specular --blur-material 0.3
icon-composer glass ./out/AppIcon.icon --group-index 1 --specular --shadow-kind neutral
# Render Liquid Glass
icon-composer render ./out/AppIcon.icon glass-preview.png
src/lib/ Pure library (bundle, manifest, render, ictool)
src/lib/ops-*.ts Operations layer (MCP result format)
src/cli.ts CLI (Commander.js, 14 commands)
src/server.ts MCP server (thin wrapper, 12 tools + 3 prompts)
# Install dependencies
bun install
# Run tests
bun test # 175 unit tests
npm run test:mcp # 16 MCP integration tests
# Build
bun run build
# Visual test gallery
bun src/cli.ts visual-test --out ./gallery
CLI and MCP server for creating Apple .icon bundles with Liquid Glass effects (iOS 26+)
{ "mcpServers": { "icon-composer-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Icon Composer 透過 stdio 在本機執行。
上次檢查時間:2026-11-16。 CLI and MCP server for creating Apple .icon bundles with Liquid Glass effects (iOS 26+)