# imagcon-mcp
以下摘录自该仓库的 README(片段) · 在 GitHub 读完整 README →
Local MCP server that wraps the Imagcon API so assistants can generate PWA icon sets (all sizes, maskable assets, manifest.json) and iOS splash screens without opening the site. Runs as a stdio process via uvx — no hosted service dependency, no persistent connections.
Requirements
- Python 3.11–3.12
- uv (provides uvx)
- An Imagcon API key starting with ic_live_ from imagcon.app/api-keys
Install
The package is self-hosted (not on PyPI). Install directly from the wheel:
Or with the key in the environment instead of on the command line:
For other MCP clients (Cursor, Windsurf, VS Code, Cline, Zed, Warp, Continue.dev), use the equivalent stdio config:
Per-client config file locations and full examples: see CLIENT-CONFIGS in imagcon.app/.well-known/blueprint.txt.
Tools
**Images**
- **generate_image** — AI-generate a source image from a text description. Returns image_key and a preview URL. Show the preview to the user and confirm before generating icons.
- **save_image** — Save a generated image to your gallery by image_key and name.
- **list_saved_images** — List all saved source images with keys and preview URLs.
- **create_icons_from_key** — Generate a PWA install pack from an already-saved image_key. Returns html_head + a signed ZIP URL; local stdio also extracts to output_dir (default ./).
- **install_pwa_pack** — Same builder as create_icons_from_key. Splash is a second credit and defaults to false.
**Icon sets**
- **generate_pwa_icons** — AI-generate a source image, then a droppable public/ tree. Extract to output_dir (default ./). Do not pass ./public/icons — that nests.
- **create_pwa_icons_from_image** — Same PWA pipeline from an existing local PNG/JPEG/WebP at image_path (no AI generation).
- **list_saved_icon_sets** — List saved icon sets with IDs.
- **download_icon_set** — Download a saved icon set ZIP by set_id, extract to output_dir.
- **get_icon_set_download_url** — Get an authenticated download URL for a saved icon set ZIP by set_id.
**Splash screens**
- **generate_splash_screens** — AI-generate a source image and produce 16 iOS splash screens, extract to output_dir (default ./public/splash).
- **create_splash_screens_from_image** — Same splash pipeline from an existing local PNG/JPEG/WebP at image_path (no AI generation).
- **create_splash_screens_from_key** — Same splash pipeline from an existing image_key (e.g. from generate_image or list_saved_images) — composites the icon on each canvas size without re-generating.
- **download_splash_screens** — Download a saved splash screen set ZIP by set_id, extract to output_dir.
- **get_splash_screen_download_url** — Get an authenticated download URL for a saved splash screen set ZIP by set_id.
**Account**
- **get_credit_balance** — Returns remaining Imagcon credits.