mcp-duojie-image 0.7.0 → 0.9.0

package/README.md

@@ -5,7 +5,7 @@ MCP server for image generation via duojie.games GPT image API.
 ## Features
 
 - Text-to-image generation with `gpt-image-2`
-- Reference image editing via local image paths, with optional image roles
+- Reference image support: requests with reference images route through `/v1/images/edits` (multipart form); text-only requests route through `/v1/images/generations` (JSON body)
 - Prompt structuring helpers for use case, asset type, constraints, and effective prompt echo
 - Optional chroma-key transparent background post-processing
 - Async submission with task status lookup
@@ -61,6 +61,8 @@ Supported `input_images.role` values:
 - `composition_reference`
 - `insert_source`
 
+**Endpoint routing:** Any request with reference images is sent to `/v1/images/edits` as a multipart form, which correctly handles both reference images and the `size`/`aspect_ratio` parameters. Text-only requests (no reference images) are sent to `/v1/images/generations` as a JSON body. The `role` field on `input_images` is used only for prompt structuring, not for endpoint selection.
+
 When both `input_images` and `reference_images` are provided, `input_images` takes precedence. `generate_image` returns `effective_prompt` so callers can diagnose the exact prompt sent upstream.
 
 Response:

package/dist/index.js

@@ -34,7 +34,7 @@ const server = new McpServer({
     version: "0.1.0",
 });
 server.registerTool("generate_image", {
-    description: "Generate image async with gpt-image-2. Return after tool call; don't wait/check.",
+    description: "Generate image async with gpt-image-2. Reference images route through /v1/images/edits (multipart form); text-only requests route through /v1/images/generations. Return after tool call; don't wait/check.",
     inputSchema: z.object({
         prompt: z.string().min(1).describe("Prompt"),
         output_dir: z.string().describe("Absolute output dir"),

package/dist/prompt.js

@@ -83,5 +83,6 @@ export function preparePrompt(opts) {
     return {
         prompt,
         imagePaths: inputImages?.map((image) => image.path) ?? [],
+        imageInputs: inputImages,
     };
 }

package/dist/provider.js

@@ -105,12 +105,16 @@ async function generateOpenAIImage(config, opts) {
     const prompt = opts.prompt;
     const size = mapOpenAISize(opts.size, opts.aspectRatio);
     const hasReferenceImages = Boolean(opts.referenceImages?.length);
-    const url = `${config.baseUrl}${hasReferenceImages ? "/v1/images/edits" : "/v1/images/generations"}`;
+    // 有参考图 → /v1/images/edits（multipart form）
+    // 无参考图 → /v1/images/generations（JSON body，纯文本）
+    const useEdits = hasReferenceImages;
+    const url = `${config.baseUrl}${useEdits ? "/v1/images/edits" : "/v1/images/generations"}`;
     let body;
     let headers = {
         Authorization: `Bearer ${config.apiKey}`,
     };
-    if (hasReferenceImages) {
+    if (useEdits) {
+        // 有参考图：multipart form
         const form = new FormData();
         form.set("model", GPT_IMAGE_MODEL);
         form.set("prompt", prompt);
@@ -126,6 +130,7 @@ async function generateOpenAIImage(config, opts) {
         body = form;
     }
     else {
+        // 纯文本生成
         headers = { ...headers, "Content-Type": "application/json" };
         body = JSON.stringify({
             model: GPT_IMAGE_MODEL,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-duojie-image",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "MCP server for image generation via duojie.games",
   "type": "module",
   "main": "dist/index.js",