imagegen-mcp

forgemesh-imagegen

用于 AI 图像生成的 MCP 服务。 通过一次 MCP 工具调用即可生成图像、移除背景并放大至 4 倍高清。通过 x402 在 Base 主网上使用 USDC 自动处理付款。无需 API 密钥，无需订阅，按张付费。

属于 ForgeMesh 生态系统——为自主 Agent 提供基础设施。

---

工具

工具	功能	价格
generate_image	标准文生图	$0.25 USDC
generate_clean	生成图像并移除背景	$0.35 USDC
generate_hd	高级生成并放大至 4 倍（高清）	$0.50 USDC
generate_pro	顶级生成、移除背景并放大至 4 倍	$0.75 USDC
list_presets	列出 58 个保留身份特征的转换预设（人物或宠物）	$0.005 USDC
transform_image	使用预设转换照片，同时保留主体身份（FLUX Kontext Max）	$0.75 USDC

四种 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：轮询免费的状态 URL，直到 PNG 准备就绪，通常需要 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...

---

要求

• 一个专用、低余额的 Base 主网钱包私钥，其中持有 USDC（切勿使用你的主钱包：该服务会自主签署 USDC 转账）
• $1 USDC ≈ 可生成 4 张基础图像、2 张背景清理图像、2 张高清图像、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://..." }

---

工作原理

每次工具调用都会向 ForgeMesh 图像生成服务发送 HTTP 请求，该服务由 x402 协议控制访问。如果需要付款，MCP 会自动使用你的钱包在 Base 主网上签署并广播 USDC 转账，然后重试请求。你会看到结果，钱包会被扣款，无需手动操作。

• 网络：Base 主网（eip155:8453）
• 代币：USDC
• 协议：x402
• 服务仅连接至 https://imagegen.coinopai.com；每个请求的超时时间为 60 秒，响应上限为 1 MB；不经过第三方支付路由器或联盟营销跳转。

---

链接

• ForgeMesh — 生态系统概览
• npm
• x402 协议

---

许可证

MIT © ForgeMesh Labs