forgemesh-imagegen 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CoinOpAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,103 @@
+# forgemesh-imagegen
+
+**MCP server for AI image generation.** Generate images, remove backgrounds, upscale to 4x HD — all from a single MCP tool call. Payments handled automatically in USDC on Base mainnet via x402. No API key. No subscription. Pay per image.
+
+Part of the [ForgeMesh](https://github.com/forgemeshlabs/forgemesh) ecosystem — infrastructure for autonomous agents.
+
+---
+
+## Tools
+
+| Tool | What it does | Price |
+|---|---|---|
+| `generate_image` | Text-to-image generation | $0.10 USDC |
+| `generate_clean` | Generate + background removal | $0.15 USDC |
+| `generate_hd` | Generate + 4x upscale (HD) | $0.20 USDC |
+| `generate_pro` | Generate + bg removal + 4x upscale | $0.30 USDC |
+
+All tools accept `prompt` (required) and `aspect` (optional: `1:1`, `16:9`, `9:16`, `4:3`).
+
+---
+
+## Install
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "forgemesh-imagegen": {
+      "command": "npx",
+      "args": ["-y", "forgemesh-imagegen"],
+      "env": {
+        "WALLET_PRIVATE_KEY": "0x..."
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add forgemesh-imagegen -- npx -y forgemesh-imagegen
+```
+
+Then set the env var:
+```bash
+export WALLET_PRIVATE_KEY=0x...
+```
+
+---
+
+## Requirements
+
+- A Base mainnet wallet private key with USDC
+- $1 USDC ≈ 10 base images, 6 clean, 5 HD, or 3 pro
+- No other API keys needed
+
+Get USDC on Base: [Coinbase](https://coinbase.com) → Bridge to Base, or buy directly on Base.
+
+---
+
+## Example usage
+
+```
+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
+```
+
+---
+
+## How it works
+
+Each tool call makes an HTTP request to the ForgeMesh imagegen service gated by the [x402 protocol](https://x402.org). If payment is required, the MCP automatically signs and broadcasts a USDC transfer from your wallet on Base mainnet — then retries the request. You see the result, your wallet is charged, no manual steps.
+
+- Network: Base mainnet (eip155:8453)
+- Token: USDC
+- Facilitator: Coinbase CDP
+
+---
+
+## Links
+
+- [ForgeMesh](https://forgemesh.io) — ecosystem overview
+- [GitHub](https://github.com/forgemeshlabs/forgemesh-imagegen)
+- [x402 Protocol](https://x402.org)
+
+---
+
+## License
+
+MIT © ForgeMesh Labs

package/index.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+"use strict";
+
+const { Server } = require("@modelcontextprotocol/sdk/server/index.js");
+const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
+const { CallToolRequestSchema, ListToolsRequestSchema } = require("@modelcontextprotocol/sdk/types.js");
+const { x402Client, x402HTTPClient } = require("@x402/core/client");
+const { ExactEvmScheme } = require("@x402/evm/exact/client");
+const { toClientEvmSigner } = require("@x402/evm");
+const { privateKeyToAccount } = require("viem/accounts");
+
+const BASE_URL = "https://imagegen.coinopai.com";
+const VALID_ASPECTS = ["1:1", "16:9", "9:16", "4:3"];
+
+const TOOLS = [
+  {
+    name: "generate_image",
+    description: "Generate an AI image from a text prompt. Returns a PNG image URL. Costs $0.10 USDC on Base mainnet — paid automatically.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        prompt: { type: "string", description: "Text description of the image to generate" },
+        aspect: { type: "string", enum: VALID_ASPECTS, description: "Aspect ratio — 1:1 (default), 16:9, 9:16, 4:3" },
+      },
+      required: ["prompt"],
+    },
+  },
+  {
+    name: "generate_clean",
+    description: "Generate an AI image with the background removed. Returns a transparent PNG URL. Costs $0.15 USDC on Base mainnet.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        prompt: { type: "string", description: "Text description of the subject (background will be removed)" },
+        aspect: { type: "string", enum: VALID_ASPECTS, description: "Aspect ratio — 1:1 (default), 16:9, 9:16, 4:3" },
+      },
+      required: ["prompt"],
+    },
+  },
+  {
+    name: "generate_hd",
+    description: "Generate an AI image upscaled to 4x resolution. Returns a high-resolution image URL. Costs $0.20 USDC on Base mainnet.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        prompt: { type: "string", description: "Text description of the image to generate" },
+        aspect: { type: "string", enum: VALID_ASPECTS, description: "Aspect ratio — 1:1 (default), 16:9, 9:16, 4:3" },
+      },
+      required: ["prompt"],
+    },
+  },
+  {
+    name: "generate_pro",
+    description: "Generate an AI image with background removed AND upscaled 4x HD. The full pipeline. Costs $0.30 USDC on Base mainnet.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        prompt: { type: "string", description: "Text description of the subject (background removed, then upscaled)" },
+        aspect: { type: "string", enum: VALID_ASPECTS, description: "Aspect ratio — 1:1 (default), 16:9, 9:16, 4:3" },
+      },
+      required: ["prompt"],
+    },
+  },
+];
+
+const TOOL_ENDPOINTS = {
+  generate_image: { path: "/generate", price: "$0.10" },
+  generate_clean: { path: "/generate/clean", price: "$0.15" },
+  generate_hd:    { path: "/generate/hd",    price: "$0.20" },
+  generate_pro:   { path: "/generate/pro",   price: "$0.30" },
+};
+
+function buildHttpClient() {
+  const key = process.env.WALLET_PRIVATE_KEY;
+  if (!key) {
+    throw new Error(
+      "WALLET_PRIVATE_KEY required — set a Base wallet private key funded with USDC.\n" +
+      "  generate_image = $0.10 | generate_clean = $0.15 | generate_hd = $0.20 | generate_pro = $0.30"
+    );
+  }
+  const pk = key.startsWith("0x") ? key : "0x" + key;
+  const account = privateKeyToAccount(pk);
+  const signer = toClientEvmSigner(account);
+  const coreClient = new x402Client().register("eip155:*", new ExactEvmScheme(signer));
+  return new x402HTTPClient(coreClient);
+}
+
+async function callPaid(httpClient, path, params) {
+  const url = new URL(BASE_URL + path);
+  if (params) Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, v));
+
+  const res = await fetch(url.toString());
+
+  if (res.status === 402) {
+    let body;
+    try { body = await res.clone().json(); } catch (_) {}
+    const paymentRequired = httpClient.getPaymentRequiredResponse(
+      (name) => res.headers.get(name),
+      body
+    );
+    const paymentPayload = await httpClient.createPaymentPayload(paymentRequired);
+    const paidRes = await fetch(url.toString(), {
+      headers: httpClient.encodePaymentSignatureHeader(paymentPayload),
+    });
+    if (!paidRes.ok) {
+      const errBody = await paidRes.text().catch(() => paidRes.statusText);
+      throw new Error(`Payment failed — HTTP ${paidRes.status}: ${errBody.slice(0, 200)}`);
+    }
+    return paidRes.json();
+  }
+
+  if (!res.ok) {
+    const errBody = await res.text().catch(() => res.statusText);
+    throw new Error(`HTTP ${res.status}: ${errBody.slice(0, 200)}`);
+  }
+  return res.json();
+}
+
+async function main() {
+  let httpClient;
+  try {
+    httpClient = buildHttpClient();
+  } catch (e) {
+    process.stderr.write("[forgemesh-imagegen] " + e.message + "\n");
+    process.exit(1);
+  }
+
+  const server = new Server(
+    { name: "forgemesh-imagegen", version: "1.0.0" },
+    { capabilities: { tools: {} } }
+  );
+
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+
+  server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const { name, arguments: args } = req.params;
+    try {
+      const endpoint = TOOL_ENDPOINTS[name];
+      if (!endpoint) throw new Error("Unknown tool: " + name);
+
+      if (!args.prompt || typeof args.prompt !== "string" || !args.prompt.trim()) {
+        throw new Error("prompt is required and must be a non-empty string");
+      }
+
+      const aspect = args.aspect || "1:1";
+      if (!VALID_ASPECTS.includes(aspect)) {
+        throw new Error(`Invalid aspect ratio '${aspect}'. Valid: ${VALID_ASPECTS.join(", ")}`);
+      }
+
+      const data = await callPaid(httpClient, endpoint.path, {
+        prompt: args.prompt.trim(),
+        aspect,
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            image_url: data.image_url,
+            prompt: data.prompt,
+            aspect: data.aspect,
+            tier: name.replace("generate_", "") || "base",
+            generated_at: data.generated_at || new Date().toISOString(),
+          }, null, 2),
+        }],
+      };
+    } catch (e) {
+      return { content: [{ type: "text", text: "Error: " + e.message }], isError: true };
+    }
+  });
+
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main();

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "forgemesh-imagegen",
+  "version": "1.0.0",
+  "mcpName": "io.github.forgemeshlabs/imagegen-mcp",
+  "description": "MCP server for AI image generation — generate, clean (bg removal), HD (4x upscale), Pro. Pay per image in USDC via x402 on Base. No API key needed.",
+  "main": "index.js",
+  "bin": {
+    "forgemesh-imagegen": "index.js"
+  },
+  "files": [
+    "index.js",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node index.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "imagegen",
+    "imagegen-mcp",
+    "image-generation",
+    "ai-image",
+    "image-upscaling",
+    "background-removal",
+    "forgemesh",
+    "x402",
+    "usdc",
+    "base",
+    "micropayments",
+    "agent-commerce",
+    "claude",
+    "ai-agents",
+    "generative-ai",
+    "text-to-image"
+  ],
+  "author": "ForgeMesh Labs",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/forgemeshlabs/forgemesh-imagegen.git"
+  },
+  "homepage": "https://github.com/forgemeshlabs/forgemesh-imagegen",
+  "bugs": {
+    "url": "https://github.com/forgemeshlabs/forgemesh-imagegen/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.10.1",
+    "@x402/core": "^2.11.0",
+    "@x402/evm": "^2.11.0",
+    "viem": "^2.0.0"
+  }
+}