Imagcon

imagcon-mcp

Imagcon API をラップし、サイトを開かずにアシスタントが PWA アイコンセット（すべてのサイズ、マスカブルアセット、manifest.json）や iOS スプラッシュ画面を生成できるローカル MCP サーバーです。uvx を介して stdio プロセスとして実行されるため、ホスト型サービスへの依存や永続的な接続はありません。

要件

• Python 3.11–3.12
• uv（uvx を提供）
• imagcon.app/api-keys で取得する、ic_live_ で始まる Imagcon API キー

インストール

このパッケージはセルフホスト可能です（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 — image_path にある既存のローカル PNG/JPEG/WebP 画像から、同じ 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 — image_path にある既存のローカル PNG/JPEG/WebP 画像から、同じスプラッシュ画面パイプラインを実行します（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 のプロファイルトークン、名前、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 はサポートされていません）。