imagcon-mcp 是一个本地 stdio 进程运行的 MCP 服务器,封装 Imagcon API,让 AI 助手无需打开网站即可生成 PWA 图标集与 iOS 启动画面。它不依赖托管服务,也没有持久连接。
用途:从文本描述 AI 生成源图,并产出可直接部署的图标资源;也能基于已有本地图片或已保存图片生成图标与启动画面。
主要能力:generate_image(AI 生成源图,返回 image_key 与预览 URL);save_image、list_saved_images(保存与列出源图);create_icons_from_key、install_pwa_pack、generate_pwa_icons(生成 PWA 安装包,返回 html_head 与签名 ZIP URL,本地 stdio 可解压到 output_dir);create_pwa_icons_from_image(从本地 PNG/JPEG/WebP 生成,跳过 AI 生成);list_saved_icon_sets、download_icon_set、get_icon_set_download_url(管理已保存图标集);generate_splash_screens、create_splash_screens_from_image、create_splash_screens_from_key、download_splash_screens、get_splash_screen_download_url(生成与管理 iOS 启动画面);get_credit_balance(查询剩余积分);setup_wallet_profile(在 x402 按次付费后激活永久账户,需钱包地址、X-Imagcon-Token 中的 profile token、名称、terms_confirmed 及指定格式的钱包签名)。
使用方式:需要 Python 3.11–3.12、uv(提供 uvx),以及从 imagcon.app/api-keys 获取以 ic_live_ 开头的 API key。包为自托管,不在 PyPI,需从 wheel 直接安装。支持 Cursor、Windsurf、VS Code、Cline、Zed、Warp、Continue.dev 等 MCP 客户端,使用等效 stdio 配置;各客户端配置文件位置见 imagcon.app/.well-known/blueprint.txt。所有请求仅发往 https://imagcon.app。
限制:AI 生成与图标/启动画集导出消耗积分;从已有图片或 image_key 创建可跳过 AI 生成积分,但导出仍计费;缺少 key 时进程报错退出;不支持其他 base URL。
生成流程中建议先向用户展示预览并确认后再生成图标。install_pwa_pack 的启动画面为额外一次计费,默认 false;output_dir 默认 ./,不要传入 ./public/icons 以免嵌套。