
Icon Composer Mcp
io.github.ethbak由 GitHub 账号 ethbak 发布v1.1.0更新于 Oct 24, 2026
CLI and MCP server for creating Apple .icon bundles with Liquid Glass effects (iOS 26+)
概览
创建和编辑带 Liquid Glass 效果的 Apple .icon 图标包,并导出预览图和 App Store 营销图标。
- 可以做什么
- 提供 12 个 MCP 工具和 3 个引导式提示,用于从 PNG 或 SVG 图形构建 Apple .icon 图标包。工具可创建图标包、添加或删除图层与分组、设置背景填充、配置高光、模糊、阴影和半透明等 Liquid Glass 效果,并定义深色或色调外观覆盖。它还能导出预览 PNG、通过 Apple 的 ictool 渲染像素级精确的 Liquid Glass,以及导出用于 App Store Connect 的扁平 1024x1024 营销图标。
- 适用场景
- 适合需要生成或迭代 iOS 26+ 应用图标、标志或品牌图标集的场景,包括深色模式变体和 App Store 营销素材。最适合希望获得 Liquid Glass 渲染的 macOS 用户;扁平预览和图标包编辑在其他平台也可用。
- 运行要求
- 通过 npx icon-composer-mcp 以 stdio 在本地运行,需要 Node.js 18+。Liquid Glass 渲染需要 macOS 并安装 Apple 的 Icon Composer.app;扁平预览、图标包创建与编辑以及营销导出可在任意平台使用。未声明需要账户、API 密钥或环境变量。
安装
在 SourceWeft 中
- 打开 控制台中的 Icon Composer Mcp,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
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
[图片] Claude Code
[图片] 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.
[图片] 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.
[图片] 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
来源:README.md,提交 e7d2b32
工具
0版本历史
1- v1.1.0最新Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分