imagegen-mcp

forgemesh-imagegen

AI 画像生成用の MCP サーバーです。 画像の生成、背景の削除、4 倍の HD アップスケールを、1 回の MCP ツール呼び出しだけで行えます。支払いは x402 を介して Base メインネット上の USDC で自動処理されます。API キーは不要です。サブスクリプションも不要です。画像ごとの従量課金です。

自律型エージェント向けインフラストラクチャである ForgeMesh エコシステムの一部です。

---

ツール

ツール	機能	価格
generate_image	標準的なテキストから画像への生成	$0.25 USDC
generate_clean	生成＋背景削除	$0.35 USDC
generate_hd	プレミアム生成＋4 倍アップスケール（HD）	$0.50 USDC
generate_pro	最上位の生成＋背景削除＋4 倍アップスケール	$0.75 USDC
list_presets	アイデンティティを保持する 58 種類の変換プリセット（人物またはペット）の一覧表示	$0.005 USDC
transform_image	被写体のアイデンティティを維持しながら、プリセットを使って写真を変換（FLUX Kontext Max）	$0.75 USDC

4 つの generate_* ツールは、prompt（必須）と aspect（省略可能：1:1、16:9、9:16、4:3）を受け取ります。 transform_image は、公開された image_url、list_presets の preset ID、省略可能な aspect（デフォルトは match_input_image。または 1:1、16:9、9:16、4:3、3:4）、および wait（デフォルトは true。PNG の準備ができるまで無料のステータス URL をポーリングします。通常 15～30 秒）を受け取ります。権利を有する画像のみを送信してください。未成年者は禁止です。プロバイダーの安全フィルターが適用されます。

---

インストール

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "forgemesh-imagegen": {
      "command": "npx",
      "args": ["-y", "forgemesh-imagegen"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Claude Code

claude mcp add forgemesh-imagegen -- npx -y forgemesh-imagegen

次に、環境変数を設定します。

export WALLET_PRIVATE_KEY=0x...

---

要件

• USDC を保有する、専用の低残高な Base メインネットウォレットの秘密鍵（サーバーが自動的に USDC 送金に署名するため、メインのウォレットは絶対に使用しないでください）
• $1 USDC で、ベース画像なら約 4 枚、背景削除なら 2 枚、HD なら 2 枚、Pro なら 1 枚、または変換なら 1 枚を利用できます
• ほかの API キーは不要です

Base 上で USDC を入手するには、Coinbase から Base にブリッジするか、Base 上で直接購入してください。

---

使用例

generate_image(prompt="a red panda in a spacesuit", aspect="1:1")
→ { image_url: "https://...", prompt: "...", aspect: "1:1", tier: "image" }

generate_clean(prompt="a product photo of a ceramic mug")
→ { image_url: "https://...", tier: "clean" }   // transparent PNG

generate_hd(prompt="a futuristic city at night, cyberpunk style")
→ { image_url: "https://...", tier: "hd" }       // 4096x4096

generate_pro(prompt="a logo mark, geometric eagle")
→ { image_url: "https://...", tier: "pro" }      // transparent + HD

list_presets()
→ { count: 58, presets: [{ id: "pet-royal", title: "Pet Royalty", subject: "pet", ... }, ...] }

transform_image(image_url="https://example.com/my-dog.jpg", preset="pet-royal")
→ { job_id: "...", status: "succeeded", preset: "pet-royal", image_url: "https://..." }

---

仕組み

各ツール呼び出しは、x402 プロトコルによって制御された ForgeMesh 画像生成サービスに HTTP リクエストを送信します。支払いが必要な場合、MCP が Base メインネット上のウォレットから USDC 送金に自動的に署名してブロードキャストし、その後リクエストを再試行します。結果が表示され、ウォレットから料金が引き落とされます。手動の手順は不要です。

• ネットワーク：Base メインネット（eip155:8453）
• トークン：USDC
• プロトコル：x402
• サーバーは https://imagegen.coinopai.com にのみ接続します。すべてのリクエストには 60 秒のタイムアウトと 1 MB のレスポンス上限が設定されており、サードパーティの決済ルーターやアフィリエイト経由の中継はありません。

---

リンク

• ForgeMesh — エコシステムの概要
• npm
• x402 プロトコル

---

ライセンス

MIT © ForgeMesh Labs