imageforge-mcp 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Image2Gen MCP contributors
+
+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,317 @@
+# ImageForge MCP
+
+English | [中文](#中文说明)
+
+A lightweight TypeScript MCP server for generating and editing images with `gpt-image-2` through the OpenAI Images API.
+
+- Text-to-image requests use `POST /v1/images/generations`.
+- Image editing and reference-image generation use multipart `POST /v1/images/edits`.
+- Generated images are returned as native MCP `image` content blocks and can optionally be saved locally.
+
+## Features
+
+- Model: `gpt-image-2`
+- MCP tools: `generate_image` and `edit_image`
+- Text-to-image generation
+- Image generation guided by one or more reference images
+- Editing one or more existing images
+- Local absolute paths and HTTP(S) URLs as image inputs
+- PNG, JPEG, and WebP input and output
+- Up to 16 input images, with a 50 MB limit per image
+- Optional local output path with automatic parent-directory creation
+- Safe URL validation against loopback, link-local, and private network targets
+- stdio transport
+
+## OpenAI-compatible CPA and gateway support
+
+ImageForge MCP works with OpenAI and with CPA, relay, or proxy services that implement a compatible OpenAI Images API. This includes deployments based on projects such as **New API**, **CLI Proxy API**, and similar OpenAI-compatible gateways.
+
+Compatibility depends on the gateway implementation rather than its product name:
+
+- Text-to-image requires `POST /v1/images/generations`.
+- Reference-image generation and editing require multipart `POST /v1/images/edits` with `image[]` file forwarding.
+- Responses must include Base64 image data in `data[0].b64_json`.
+- The configured model name must accept `gpt-image-2`.
+
+A gateway that only implements `/v1/images/generations` can be used for text-to-image generation, but not for reference-image generation or editing.
+
+## Requirements
+
+- Node.js 22 or later
+- An OpenAI API key or a token issued by a compatible CPA/gateway
+
+## Install and build
+
+```bash
+npm install
+npm run build
+```
+
+## MCP client configuration
+
+Inject credentials through the MCP client environment:
+
+```json
+{
+  "mcpServers": {
+    "imageforge": {
+      "command": "node",
+      "args": ["/absolute/path/to/ImageForgeMCP/dist/index.js"],
+      "env": {
+        "OPENAI_BASE_URL": "https://your-openai-compatible-gateway.example/v1",
+        "OPENAI_API_KEY": "your-token",
+        "OPENAI_IMAGE_MODEL": "gpt-image-2"
+      }
+    }
+  }
+}
+```
+
+`OPENAI_BASE_URL` defaults to `https://api.openai.com/v1`. Set it to the `/v1` root of your New API, CLI Proxy API, or other OpenAI-compatible gateway. ImageForge MCP appends `/images/generations` or `/images/edits` as required.
+
+Do not commit real API keys to Git or write them into shared configuration files.
+
+## Codex local development configuration
+
+Create a project-scoped `.codex/config.toml` using paths that match your machine:
+
+```toml
+[mcp_servers.imageforge_dev]
+command = "/absolute/path/to/node"
+args = ["/absolute/path/to/ImageForgeMCP/dist/index.js"]
+cwd = "/absolute/path/to/ImageForgeMCP"
+env_vars = ["OPENAI_API_KEY", "OPENAI_BASE_URL", "OPENAI_IMAGE_MODEL"]
+startup_timeout_sec = 10
+tool_timeout_sec = 300
+enabled = true
+required = false
+```
+
+Export the environment variables before starting Codex:
+
+```bash
+export OPENAI_API_KEY="your-gateway-token"
+export OPENAI_BASE_URL="https://your-openai-compatible-gateway.example/v1"
+export OPENAI_IMAGE_MODEL="gpt-image-2"
+
+cd /absolute/path/to/ImageForgeMCP
+codex app
+```
+
+Codex loads project-scoped `.codex/config.toml` only for trusted projects. After adding or changing the MCP configuration, restart Codex or open a new task, then use `/mcp verbose` to confirm that `imageforge_dev` exposes:
+
+- `generate_image`
+- `edit_image`
+
+After changing the TypeScript source, rebuild `dist/index.js` and restart the task using the MCP server:
+
+```bash
+npm run build
+```
+
+See the [official Codex MCP documentation](https://developers.openai.com/codex/mcp) for all configuration options.
+
+## `generate_image`
+
+| Parameter | Required | Default | Description |
+| --- | --- | --- | --- |
+| `prompt` | Yes | - | Image description |
+| `model` | No | Environment or `gpt-image-2` | Only `gpt-image-2` is accepted |
+| `base_url` | No | `OPENAI_BASE_URL` | Per-call API base URL override |
+| `api_key` | No | `OPENAI_API_KEY` | Per-call credential override; environment variables are preferred |
+| `size` | No | `1024x1024` | Output size requested from the provider |
+| `quality` | No | `auto` | `auto`, `low`, `medium`, or `high` |
+| `output_format` | No | `png` | `png`, `jpeg`, or `webp` |
+| `output_path` | No | - | Local save path; relative paths resolve from the MCP working directory |
+| `reference_images` | No | - | Reference images as local absolute paths or HTTP(S) URLs |
+
+Without `reference_images`, the tool uses `/images/generations`. With reference images, it uploads them as multipart `image[]` files to `/images/edits`.
+
+## `edit_image`
+
+`edit_image` uses the same model, API, output, and local-save parameters as `generate_image`, but requires `input_images`:
+
+| Parameter | Required | Description |
+| --- | --- | --- |
+| `prompt` | Yes | Editing instructions |
+| `input_images` | Yes | 1–16 local absolute paths or HTTP(S) URLs |
+
+Local images are read directly. URL images are downloaded and validated before upload. URLs resolving to loopback, link-local, or private addresses are rejected.
+
+Configuration precedence is: tool arguments, environment variables, then built-in defaults.
+
+When `output_path` is supplied, ImageForge MCP returns the native MCP image content block, saves the decoded image, and includes the final absolute path in a text content block. Missing parent directories are created automatically. Existing files are not overwritten.
+
+Some OpenAI-compatible gateways may return dimensions different from the requested `size`; the actual returned file dimensions are authoritative.
+
+## Verification
+
+```bash
+npm test
+npm run check
+```
+
+Tests use a local HTTP mock. They do not call a real image API or incur generation charges.
+
+## License
+
+[MIT](./LICENSE)
+
+---
+
+# 中文说明
+
+ImageForge MCP 是一个轻量的 TypeScript MCP 图片生成与编辑服务，通过 OpenAI Images API 调用 `gpt-image-2`。
+
+- 纯文本生图调用 `POST /v1/images/generations`。
+- 图片编辑和参考图生图调用 multipart `POST /v1/images/edits`。
+- 生成结果以原生 MCP `image` 内容块返回，也可以同时保存到本地。
+
+## 功能
+
+- 模型：`gpt-image-2`
+- MCP 工具：`generate_image`、`edit_image`
+- 支持纯文本生图
+- 支持一张或多张参考图引导生图
+- 支持一张或多张图片编辑
+- 输入图片支持本地绝对路径和 HTTP(S) URL
+- 输入与输出支持 PNG、JPEG、WebP
+- 最多 16 张输入图片，每张不超过 50 MB
+- 支持通过 `output_path` 保存到本地，并自动创建父目录
+- URL 安全校验，拒绝访问环回、链路本地和私有网络地址
+- stdio Transport
+
+## OpenAI 兼容 CPA 与网关
+
+ImageForge MCP 不仅支持 OpenAI 官方接口，也支持实现了 OpenAI Images API 兼容协议的 CPA、中转或代理服务，包括基于 **New API**、**CLI Proxy API** 等项目部署的 OpenAI 兼容网关。
+
+是否兼容取决于网关实现的接口能力，而不是产品名称：
+
+- 纯文本生图需要实现 `POST /v1/images/generations`。
+- 参考图生图和图片编辑需要实现 multipart `POST /v1/images/edits`，并正确转发 `image[]` 文件。
+- 响应需要在 `data[0].b64_json` 中返回 Base64 图片数据。
+- 网关需要接受 `gpt-image-2` 模型名。
+
+如果网关只实现了 `/v1/images/generations`，仍可用于纯文本生图，但不能使用参考图生图和图片编辑。
+
+## 环境要求
+
+- Node.js 22 或更高版本
+- OpenAI API Key，或 OpenAI 兼容 CPA/网关签发的令牌
+
+## 安装与构建
+
+```bash
+npm install
+npm run build
+```
+
+## MCP 客户端配置
+
+推荐通过 MCP 客户端环境变量注入密钥：
+
+```json
+{
+  "mcpServers": {
+    "imageforge": {
+      "command": "node",
+      "args": ["/absolute/path/to/ImageForgeMCP/dist/index.js"],
+      "env": {
+        "OPENAI_BASE_URL": "https://你的-OpenAI-兼容网关域名/v1",
+        "OPENAI_API_KEY": "你的令牌",
+        "OPENAI_IMAGE_MODEL": "gpt-image-2"
+      }
+    }
+  }
+}
+```
+
+`OPENAI_BASE_URL` 默认是 `https://api.openai.com/v1`。使用 New API、CLI Proxy API 或其他 OpenAI 兼容网关时，应填写到 `/v1` 为止；服务会根据请求追加 `/images/generations` 或 `/images/edits`。
+
+不要把真实 API Key 写入 Git 或其他共享配置文件。
+
+## Codex 本地开发配置
+
+根据本机路径创建项目级 `.codex/config.toml`：
+
+```toml
+[mcp_servers.imageforge_dev]
+command = "/你的/node/绝对路径"
+args = ["/你的/ImageForgeMCP/绝对路径/dist/index.js"]
+cwd = "/你的/ImageForgeMCP/绝对路径"
+env_vars = ["OPENAI_API_KEY", "OPENAI_BASE_URL", "OPENAI_IMAGE_MODEL"]
+startup_timeout_sec = 10
+tool_timeout_sec = 300
+enabled = true
+required = false
+```
+
+启动 Codex 前设置环境变量：
+
+```bash
+export OPENAI_API_KEY="你的网关令牌"
+export OPENAI_BASE_URL="https://你的-OpenAI-兼容网关域名/v1"
+export OPENAI_IMAGE_MODEL="gpt-image-2"
+
+cd /你的/ImageForgeMCP/绝对路径
+codex app
+```
+
+Codex 只会加载已信任项目中的 `.codex/config.toml`。新增或修改 MCP 配置后，需要重新启动 Codex 或新建任务，再使用 `/mcp verbose` 确认 `imageforge_dev` 提供以下工具：
+
+- `generate_image`
+- `edit_image`
+
+修改 TypeScript 源码后，需要重新构建并重启使用该 MCP 的任务：
+
+```bash
+npm run build
+```
+
+完整配置说明见 [Codex MCP 官方文档](https://developers.openai.com/codex/mcp)。
+
+## `generate_image`
+
+| 参数 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `prompt` | 是 | - | 图片描述 |
+| `model` | 否 | 环境变量或 `gpt-image-2` | 仅接受 `gpt-image-2` |
+| `base_url` | 否 | `OPENAI_BASE_URL` | 单次调用覆盖 API 地址 |
+| `api_key` | 否 | `OPENAI_API_KEY` | 单次调用覆盖密钥；推荐使用环境变量 |
+| `size` | 否 | `1024x1024` | 请求提供商输出的图片尺寸 |
+| `quality` | 否 | `auto` | `auto`、`low`、`medium`、`high` |
+| `output_format` | 否 | `png` | `png`、`jpeg`、`webp` |
+| `output_path` | 否 | - | 本地保存路径；相对路径按 MCP 工作目录解析 |
+| `reference_images` | 否 | - | 参考图数组，支持本地绝对路径和 HTTP(S) URL |
+
+不传 `reference_images` 时调用 `/images/generations`；传入参考图时，将图片作为 multipart `image[]` 文件上传到 `/images/edits`。
+
+## `edit_image`
+
+`edit_image` 与 `generate_image` 使用相同的模型、API、输出和本地保存参数，但 `input_images` 必填：
+
+| 参数 | 必填 | 说明 |
+| --- | --- | --- |
+| `prompt` | 是 | 编辑指令 |
+| `input_images` | 是 | 1–16 张输入图片，支持本地绝对路径或 HTTP(S) URL |
+
+本地图片会直接读取；URL 图片会经过下载和安全校验后再上传。解析到环回、链路本地或私有地址的 URL 会被拒绝。
+
+配置优先级为：工具参数、环境变量、内置默认值。
+
+传入 `output_path` 时，服务会在返回原生 MCP 图片内容块的同时保存文件，并在文本内容块中返回最终绝对路径。父目录不存在时会自动创建；已有文件不会被覆盖。
+
+部分 OpenAI 兼容网关可能不会严格遵循请求中的 `size`，应以实际返回文件的尺寸为准。
+
+## 验证
+
+```bash
+npm test
+npm run check
+```
+
+测试使用本地 HTTP mock，不会调用真实图片 API，也不会产生生图费用。
+
+## 许可证
+
+[MIT](./LICENSE)

package/dist/imageInput.d.ts

@@ -0,0 +1,10 @@
+export declare const MAX_INPUT_IMAGES = 16;
+export declare const MAX_IMAGE_BYTES: number;
+export interface LoadedImage {
+    data: Buffer;
+    fileName: string;
+    mimeType: "image/png" | "image/jpeg" | "image/webp";
+}
+export declare function loadRemoteImage(source: string, fetchImpl?: typeof fetch): Promise<LoadedImage>;
+export declare function loadLocalImage(source: string): Promise<LoadedImage>;
+export declare function loadImages(sources: string[]): Promise<LoadedImage[]>;

package/dist/imageInput.js

@@ -0,0 +1,134 @@
+import { promises as fs } from "node:fs";
+import { isIP } from "node:net";
+import { lookup } from "node:dns/promises";
+import path from "node:path";
+export const MAX_INPUT_IMAGES = 16;
+export const MAX_IMAGE_BYTES = 50 * 1024 * 1024;
+function detectMimeType(data) {
+    if (data.subarray(0, 8).equals(Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]))) {
+        return "image/png";
+    }
+    if (data[0] === 0xff && data[1] === 0xd8 && data[2] === 0xff) {
+        return "image/jpeg";
+    }
+    if (data.subarray(0, 4).toString("ascii") === "RIFF" && data.subarray(8, 12).toString("ascii") === "WEBP") {
+        return "image/webp";
+    }
+    return undefined;
+}
+function extensionFor(mimeType) {
+    return mimeType === "image/jpeg" ? ".jpg" : mimeType === "image/webp" ? ".webp" : ".png";
+}
+function validateImage(data, fileName) {
+    if (data.length === 0) {
+        throw new Error(`Input image '${fileName}' is empty.`);
+    }
+    if (data.length > MAX_IMAGE_BYTES) {
+        throw new Error(`Input image '${fileName}' exceeds the 50 MB limit.`);
+    }
+    const mimeType = detectMimeType(data);
+    if (!mimeType) {
+        throw new Error(`Input image '${fileName}' must be PNG, JPEG, or WebP.`);
+    }
+    const baseName = path.basename(fileName, path.extname(fileName)) || "image";
+    return { data, mimeType, fileName: `${baseName}${extensionFor(mimeType)}` };
+}
+function isPrivateAddress(address) {
+    if (address === "::1" || address === "::" || address.startsWith("fe80:") || address.startsWith("fc") || address.startsWith("fd")) {
+        return true;
+    }
+    if (address.startsWith("::ffff:")) {
+        return isPrivateAddress(address.slice(7));
+    }
+    const parts = address.split(".").map(Number);
+    if (parts.length !== 4 || parts.some((part) => !Number.isInteger(part)))
+        return false;
+    return (parts[0] === 10 ||
+        parts[0] === 127 ||
+        (parts[0] === 169 && parts[1] === 254) ||
+        (parts[0] === 172 && parts[1] >= 16 && parts[1] <= 31) ||
+        (parts[0] === 192 && parts[1] === 168) ||
+        parts[0] === 0);
+}
+async function assertPublicUrl(url) {
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new Error("Image URLs must use HTTP or HTTPS.");
+    }
+    if (url.username || url.password) {
+        throw new Error("Image URLs must not contain credentials.");
+    }
+    const addresses = isIP(url.hostname)
+        ? [{ address: url.hostname }]
+        : await lookup(url.hostname, { all: true, verbatim: true });
+    if (addresses.length === 0 || addresses.some(({ address }) => isPrivateAddress(address))) {
+        throw new Error(`Image URL host '${url.hostname}' resolves to a private or local address.`);
+    }
+}
+async function readLimitedResponse(response) {
+    const declaredLength = Number(response.headers.get("content-length"));
+    if (Number.isFinite(declaredLength) && declaredLength > MAX_IMAGE_BYTES) {
+        throw new Error("Remote input image exceeds the 50 MB limit.");
+    }
+    if (!response.body)
+        throw new Error("Remote input image returned an empty response body.");
+    const reader = response.body.getReader();
+    const chunks = [];
+    let total = 0;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        total += value.byteLength;
+        if (total > MAX_IMAGE_BYTES) {
+            await reader.cancel();
+            throw new Error("Remote input image exceeds the 50 MB limit.");
+        }
+        chunks.push(value);
+    }
+    return Buffer.concat(chunks, total);
+}
+export async function loadRemoteImage(source, fetchImpl = fetch) {
+    let current = new URL(source);
+    for (let redirects = 0; redirects <= 3; redirects += 1) {
+        await assertPublicUrl(current);
+        const response = await fetchImpl(current, { redirect: "manual", signal: AbortSignal.timeout(30_000) });
+        if (response.status >= 300 && response.status < 400) {
+            const location = response.headers.get("location");
+            if (!location || redirects === 3)
+                throw new Error("Remote input image has too many redirects.");
+            current = new URL(location, current);
+            continue;
+        }
+        if (!response.ok) {
+            throw new Error(`Failed to download input image (${response.status} ${response.statusText}).`);
+        }
+        const data = await readLimitedResponse(response);
+        return validateImage(data, path.basename(current.pathname) || "remote-image");
+    }
+    throw new Error("Remote input image has too many redirects.");
+}
+export async function loadLocalImage(source) {
+    if (!path.isAbsolute(source)) {
+        throw new Error(`Local image path must be absolute: '${source}'.`);
+    }
+    const handle = await fs.open(source, "r");
+    try {
+        const stats = await handle.stat();
+        if (!stats.isFile())
+            throw new Error(`Input image is not a regular file: '${source}'.`);
+        if (stats.size > MAX_IMAGE_BYTES)
+            throw new Error(`Input image '${source}' exceeds the 50 MB limit.`);
+        return validateImage(await handle.readFile(), path.basename(source));
+    }
+    finally {
+        await handle.close();
+    }
+}
+export async function loadImages(sources) {
+    if (sources.length === 0)
+        throw new Error("At least one input image is required.");
+    if (sources.length > MAX_INPUT_IMAGES)
+        throw new Error("A maximum of 16 input images is supported.");
+    return Promise.all(sources.map((source) => /^https?:\/\//i.test(source) ? loadRemoteImage(source) : loadLocalImage(source)));
+}
+//# sourceMappingURL=imageInput.js.map

package/dist/imageInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageInput.js","sourceRoot":"","sources":["../src/imageInput.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { type LoadedImage } from "./imageInput.js";
+declare const qualitySchema: z.ZodEnum<["auto", "low", "medium", "high"]>;
+declare const outputFormatSchema: z.ZodEnum<["png", "jpeg", "webp"]>;
+export interface ImageConfig {
+    apiKey: string;
+    baseUrl: string;
+    model: string;
+}
+export interface ImageGenerationResponse {
+    data?: Array<{
+        b64_json?: string;
+    }>;
+}
+export declare function resolveConfig(input: {
+    apiKey?: string;
+    baseUrl?: string;
+    model?: string;
+}): ImageConfig;
+export declare function requestImage(input: {
+    prompt: string;
+    config: ImageConfig;
+    size: string;
+    quality: z.infer<typeof qualitySchema>;
+    outputFormat: z.infer<typeof outputFormatSchema>;
+    inputImages?: LoadedImage[];
+    fetchImpl?: typeof fetch;
+}): Promise<Buffer>;
+export declare function saveImage(image: Buffer, outputPath: string): Promise<string>;
+export declare function createServer(): McpServer;
+export {};

package/dist/index.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { loadImages } from "./imageInput.js";
+const DEFAULT_BASE_URL = "https://api.openai.com/v1";
+const DEFAULT_MODEL = "gpt-image-2";
+const qualitySchema = z.enum(["auto", "low", "medium", "high"]);
+const outputFormatSchema = z.enum(["png", "jpeg", "webp"]);
+function firstValue(...values) {
+    return values.map((value) => value?.trim()).find(Boolean);
+}
+export function resolveConfig(input) {
+    const apiKey = firstValue(input.apiKey, process.env.OPENAI_API_KEY);
+    if (!apiKey) {
+        throw new Error("Missing API key: pass api_key or set OPENAI_API_KEY.");
+    }
+    const model = firstValue(input.model, process.env.OPENAI_IMAGE_MODEL, DEFAULT_MODEL);
+    if (model !== DEFAULT_MODEL) {
+        throw new Error(`Unsupported model '${model}'. This MVP only supports ${DEFAULT_MODEL}.`);
+    }
+    const baseUrl = firstValue(input.baseUrl, process.env.OPENAI_BASE_URL, DEFAULT_BASE_URL);
+    let parsedUrl;
+    try {
+        parsedUrl = new URL(baseUrl);
+    }
+    catch {
+        throw new Error("base_url must be a valid absolute HTTP(S) URL.");
+    }
+    if (parsedUrl.protocol !== "http:" && parsedUrl.protocol !== "https:") {
+        throw new Error("base_url must use HTTP or HTTPS.");
+    }
+    return {
+        apiKey,
+        model,
+        baseUrl: baseUrl.replace(/\/+$/, ""),
+    };
+}
+export async function requestImage(input) {
+    const fetchImpl = input.fetchImpl ?? fetch;
+    const commonFields = {
+        model: input.config.model,
+        prompt: input.prompt,
+        n: 1,
+        size: input.size,
+        quality: input.quality,
+        output_format: input.outputFormat,
+    };
+    const hasInputImages = Boolean(input.inputImages?.length);
+    let body;
+    let headers = { authorization: `Bearer ${input.config.apiKey}` };
+    if (hasInputImages) {
+        const form = new FormData();
+        for (const [name, value] of Object.entries(commonFields))
+            form.append(name, String(value));
+        for (const image of input.inputImages) {
+            form.append("image[]", new Blob([new Uint8Array(image.data)], { type: image.mimeType }), image.fileName);
+        }
+        body = form;
+    }
+    else {
+        headers = { ...headers, "content-type": "application/json" };
+        body = JSON.stringify(commonFields);
+    }
+    const endpoint = hasInputImages ? "edits" : "generations";
+    const response = await fetchImpl(`${input.config.baseUrl}/images/${endpoint}`, {
+        method: "POST",
+        headers,
+        body,
+    });
+    if (!response.ok) {
+        const detail = (await response.text()).slice(0, 500);
+        throw new Error(`OpenAI image request failed (${response.status}): ${detail || response.statusText}`);
+    }
+    const payload = (await response.json());
+    const encodedImage = payload.data?.[0]?.b64_json;
+    if (!encodedImage) {
+        throw new Error("OpenAI image response contained no base64 image data.");
+    }
+    const normalizedImage = encodedImage.replace(/\s+/g, "");
+    if (!/^[A-Za-z0-9+/]+={0,2}$/.test(normalizedImage)) {
+        throw new Error("OpenAI image response contained invalid base64 image data.");
+    }
+    const image = Buffer.from(normalizedImage, "base64");
+    if (image.length === 0 || image.toString("base64").replace(/=+$/, "") !== normalizedImage.replace(/=+$/, "")) {
+        throw new Error("OpenAI image response contained invalid base64 image data.");
+    }
+    return image;
+}
+export async function saveImage(image, outputPath) {
+    const resolvedPath = path.resolve(outputPath);
+    await fs.mkdir(path.dirname(resolvedPath), { recursive: true });
+    await fs.writeFile(resolvedPath, image, { flag: "wx" });
+    return resolvedPath;
+}
+async function imageResult(image, outputFormat, outputPath) {
+    const content = [
+        {
+            type: "image",
+            data: image.toString("base64"),
+            mimeType: `image/${outputFormat}`,
+        },
+    ];
+    if (outputPath) {
+        const savedPath = await saveImage(image, outputPath);
+        content.push({ type: "text", text: `Image saved to ${savedPath}` });
+    }
+    return { content };
+}
+export function createServer() {
+    const server = new McpServer({ name: "imageforge-mcp", version: "0.3.0" });
+    server.registerTool("generate_image", {
+        description: "Generate one image with gpt-image-2, optionally guided by reference images.",
+        inputSchema: {
+            prompt: z.string().trim().min(1).max(32_000).describe("Image description."),
+            model: z.string().optional().describe("Model name; only gpt-image-2 is supported."),
+            base_url: z.string().optional().describe("OpenAI-compatible base URL ending in /v1."),
+            api_key: z.string().optional().describe("Per-call API key; OPENAI_API_KEY is preferred."),
+            size: z.string().default("1024x1024").describe("Output size, for example 1536x1024."),
+            quality: qualitySchema.default("auto"),
+            output_format: outputFormatSchema.default("png"),
+            output_path: z.string().trim().min(1).optional().describe("Optional local path to save the generated image. Relative paths resolve from the MCP working directory. Existing files are not overwritten."),
+            reference_images: z.array(z.string()).max(16).optional().describe("Optional reference images as absolute local paths or HTTP(S) URLs."),
+        },
+    }, async ({ prompt, model, base_url, api_key, size, quality, output_format, output_path, reference_images }) => {
+        const config = resolveConfig({ apiKey: api_key, baseUrl: base_url, model });
+        const inputImages = reference_images?.length ? await loadImages(reference_images) : undefined;
+        const image = await requestImage({
+            prompt,
+            config,
+            size,
+            quality,
+            outputFormat: output_format,
+            inputImages,
+        });
+        return imageResult(image, output_format, output_path);
+    });
+    server.registerTool("edit_image", {
+        description: "Edit one or more input images with gpt-image-2.",
+        inputSchema: {
+            prompt: z.string().trim().min(1).max(32_000).describe("Instructions for the image edit."),
+            input_images: z.array(z.string()).min(1).max(16).describe("Input images as absolute local paths or HTTP(S) URLs."),
+            model: z.string().optional().describe("Model name; only gpt-image-2 is supported."),
+            base_url: z.string().optional().describe("OpenAI-compatible base URL ending in /v1."),
+            api_key: z.string().optional().describe("Per-call API key; OPENAI_API_KEY is preferred."),
+            size: z.string().default("1024x1024").describe("Output size, for example 1536x1024."),
+            quality: qualitySchema.default("auto"),
+            output_format: outputFormatSchema.default("png"),
+            output_path: z.string().trim().min(1).optional().describe("Optional local path to save the edited image. Relative paths resolve from the MCP working directory. Existing files are not overwritten."),
+        },
+    }, async ({ prompt, input_images, model, base_url, api_key, size, quality, output_format, output_path }) => {
+        const config = resolveConfig({ apiKey: api_key, baseUrl: base_url, model });
+        const image = await requestImage({
+            prompt,
+            config,
+            size,
+            quality,
+            outputFormat: output_format,
+            inputImages: await loadImages(input_images),
+        });
+        return imageResult(image, output_format, output_path);
+    });
+    return server;
+}
+async function main() {
+    await createServer().connect(new StdioServerTransport());
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch((error) => {
+        console.error(error instanceof Error ? error.message : error);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "imageforge-mcp",
+  "version": "0.3.0",
+  "description": "Minimal MCP server for gpt-image-2 through the OpenAI Images API",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "imageforge-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "check": "npm run build && npm test"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  }
+}