Imagcon

imagcon-mcp

本地 MCP 服务，用于封装 Imagcon API，让助手无需打开网站即可生成 PWA 图标套件（所有尺寸、可遮罩资源、manifest.json）和 iOS 启动画面。通过 uvx 以 stdio 进程运行，无需依赖托管服务，也无需持久连接。

要求

• Python 3.11–3.12
• uv（提供 uvx）
• 来自 imagcon.app/api-keys 的 Imagcon API 密钥，以 ic_live_ 开头

安装

此软件包可自托管（未发布到 PyPI）。直接从 wheel 安装：

claude mcp add imagcon -- uvx --from https://imagcon.app/downloads/imagcon_mcp-0.3.0-py3-none-any.whl imagcon-mcp --api-key ic_live_...

或者将密钥放在环境变量中，而不是命令行中：

claude mcp add imagcon -- uvx --from https://imagcon.app/downloads/imagcon_mcp-0.3.0-py3-none-any.whl imagcon-mcp

export IMAGCON_API_KEY=ic_live_...

对于其他 MCP 客户端（Cursor、Windsurf、VS Code、Cline、Zed、Warp、Continue.dev），请使用等效的 stdio 配置：

{
  "mcpServers": {
    "imagcon": {
      "command": "uvx",
      "args": ["--from", "https://imagcon.app/downloads/imagcon_mcp-0.3.0-py3-none-any.whl", "imagcon-mcp", "--api-key", "ic_live_..."]
    }
  }
}

各客户端的配置文件位置和完整示例：请参阅 imagcon.app/.well-known/blueprint.txt 中的 CLIENT-CONFIGS。

工具

图像

• generate_image — 根据文本描述使用 AI 生成源图像。返回 image_key 和预览 URL。向用户展示预览，并在生成图标前确认。
• save_image — 根据 image_key 和 name 将生成的图像保存到图库。
• list_saved_images — 列出所有已保存的源图像及其密钥和预览 URL。
• create_icons_from_key — 根据已保存的 image_key 生成 PWA 安装包。返回 html_head 和签名 ZIP URL；本地 stdio 还会将其解压到 output_dir（默认为 ./）。
• install_pwa_pack — 与 create_icons_from_key 使用相同的构建器。启动画面会额外消耗一次额度，且默认不启用。

图标套件

• generate_pwa_icons — 使用 AI 生成源图像，然后生成可直接放入项目的 public/ 目录树。解压到 output_dir（默认为 ./）。不要传入 ./public/icons，否则会嵌套目录。
• create_pwa_icons_from_image — 使用现有本地 PNG/JPEG/WebP 图像（路径为 image_path）执行相同的 PWA 流程（不使用 AI 生成）。
• list_saved_icon_sets — 列出已保存的图标套件及其 ID。
• download_icon_set — 根据 set_id 下载已保存的图标套件 ZIP，并解压到 output_dir。
• get_icon_set_download_url — 根据 set_id 获取已保存图标套件 ZIP 的经过身份验证的下载 URL。

启动画面

• generate_splash_screens — 使用 AI 生成源图像并制作 16 张 iOS 启动画面，解压到 output_dir（默认为 ./public/splash）。
• create_splash_screens_from_image — 使用现有本地 PNG/JPEG/WebP 图像（路径为 image_path）执行相同的启动画面流程（不使用 AI 生成）。
• create_splash_screens_from_key — 使用现有的 image_key（例如来自 generate_image 或 list_saved_images）执行相同的启动画面流程——将图标合成到每种画布尺寸上，不会重新生成图像。
• download_splash_screens — 根据 set_id 下载已保存的启动画面套件 ZIP，并解压到 output_dir。
• get_splash_screen_download_url — 根据 set_id 获取已保存启动画面套件 ZIP 的经过身份验证的下载 URL。

账户

• get_credit_balance — 返回剩余的 Imagcon 额度。
• setup_wallet_profile — 在完成一次性调用付费 x402 支付后，激活永久 Imagcon 账户。传入钱包地址、来自 X-Imagcon-Token 的 profile token、名称、terms_confirmed（阅读 https://imagcon.app/terms-of-service 后确认），以及针对 imagcon.app/profile/activate:{profile_token}:{unix_timestamp} 的钱包签名。

AI 图像生成（generate_image、generate_pwa_icons、generate_splash_screens）以及图标/启动画面套件导出会消耗额度。create_pwa_icons_from_image、create_splash_screens_from_image、create_splash_screens_from_key 和 create_icons_from_key 不消耗 AI 生成额度，但仍会收取导出费用。

配置

来源	变量 / 标志
环境变量	IMAGCON_API_KEY
CLI	--api-key（覆盖环境变量）

如果缺少密钥，进程会退出并报错，提示访问 imagcon.app/api-keys。

API 基础 URL

所有请求都发送至 https://imagcon.app（不支持其他基础 URL）。