mcp-hydrocoder-image 1.0.0

package/dist/server/mcpServer.js

@@ -0,0 +1,434 @@
+/**
+ * MCP Server implementation
+ * Simplified architecture with direct Gemini integration
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+// API clients
+import { createGeminiClient } from '../api/geminiClient.js';
+import { createGeminiTextClient } from '../api/geminiTextClient.js';
+// Business logic
+import { createFileManager } from '../business/fileManager.js';
+import { validateGenerateImageParams } from '../business/inputValidator.js';
+import { createResponseBuilder } from '../business/responseBuilder.js';
+import { createStructuredPromptGenerator, } from '../business/structuredPromptGenerator.js';
+// Utilities
+import { getConfig } from '../utils/config.js';
+import { Logger } from '../utils/logger.js';
+import { SecurityManager } from '../utils/security.js';
+import { ErrorHandler } from './errorHandler.js';
+/**
+ * Default MCP server configuration
+ */
+const DEFAULT_CONFIG = {
+    name: 'mcp-image-server',
+    version: '0.1.0',
+    defaultOutputDir: './output',
+};
+/**
+ * Simplified MCP server
+ */
+export class MCPServerImpl {
+    constructor(config = {}) {
+        this.server = null;
+        this.structuredPromptGenerator = null;
+        this.geminiTextClient = null;
+        this.geminiClient = null;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.logger = new Logger();
+        this.fileManager = createFileManager();
+        this.responseBuilder = createResponseBuilder();
+        this.securityManager = new SecurityManager();
+    }
+    /**
+     * Get server info
+     */
+    getServerInfo() {
+        return {
+            name: this.config.name,
+            version: this.config.version,
+        };
+    }
+    /**
+     * Get list of registered tools
+     */
+    getToolsList() {
+        return {
+            tools: [
+                {
+                    name: 'generate_image',
+                    description: 'Generate, edit, blend, or merge images using AI. Supports text-to-image generation, single image editing, and multi-image composition/blending. Use inputImagePaths for merging multiple images from file paths, or inputImages for base64 encoded images.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            prompt: {
+                                type: 'string',
+                                description: 'The prompt for image generation (English recommended for optimal structured prompt enhancement)',
+                            },
+                            fileName: {
+                                type: 'string',
+                                description: 'Custom file name for the output image. Auto-generated if not specified.',
+                            },
+                            inputImagePath: {
+                                type: 'string',
+                                description: 'Optional absolute path to source image for image-to-image generation. Use when generating variations, style transfers, or similar images based on an existing image (must be an absolute path)',
+                            },
+                            inputImage: {
+                                type: 'string',
+                                description: 'Optional base64 encoded image data for image-to-image generation. Alternative to inputImagePath when image data is already in memory. Do not include data URI prefix (e.g., "data:image/png;base64,")',
+                            },
+                            inputImageMimeType: {
+                                type: 'string',
+                                description: 'MIME type of the input image provided via inputImage. Required when inputImage is provided for accurate processing',
+                                enum: [
+                                    'image/jpeg',
+                                    'image/png',
+                                    'image/webp',
+                                    'image/gif',
+                                    'image/bmp',
+                                ],
+                            },
+                            inputImages: {
+                                type: 'array',
+                                description: 'Multiple input images for multi-image composition. Cannot be used together with inputImage or inputImagePath. Each item requires base64 data and MIME type.',
+                                items: {
+                                    type: 'object',
+                                    properties: {
+                                        data: {
+                                            type: 'string',
+                                            description: 'Base64 encoded image data. Do not include data URI prefix.',
+                                        },
+                                        mimeType: {
+                                            type: 'string',
+                                            description: 'MIME type of the image',
+                                            enum: [
+                                                'image/jpeg',
+                                                'image/png',
+                                                'image/webp',
+                                                'image/gif',
+                                                'image/bmp',
+                                            ],
+                                        },
+                                    },
+                                    required: ['data', 'mimeType'],
+                                },
+                            },
+                            inputImagePaths: {
+                                type: 'array',
+                                description: 'Multiple input image file paths for multi-image composition. Cannot be used together with inputImage, inputImagePath, or inputImages. Each path must be absolute.',
+                                items: {
+                                    type: 'string',
+                                    description: 'Absolute path to an image file',
+                                },
+                            },
+                            returnBase64: {
+                                type: 'boolean',
+                                description: 'Return the generated image as base64 data in the response. The image is always saved to disk regardless of this setting. Default: false',
+                            },
+                            blendImages: {
+                                type: 'boolean',
+                                description: 'Enable multi-image blending for combining multiple visual elements naturally. Use when prompt mentions multiple subjects or composite scenes',
+                            },
+                            maintainCharacterConsistency: {
+                                type: 'boolean',
+                                description: 'Maintain character appearance consistency. Enable when generating same character in different poses/scenes',
+                            },
+                            useWorldKnowledge: {
+                                type: 'boolean',
+                                description: 'Use real-world knowledge for accurate context. Enable for historical figures, landmarks, or factual scenarios',
+                            },
+                            useGoogleSearch: {
+                                type: 'boolean',
+                                description: "Enable Google Search grounding to access real-time web information for factually accurate image generation. Use when prompt requires current or time-sensitive data that may have changed since the model's knowledge cutoff. Leave disabled for creative, fictional, historical, or timeless content.",
+                            },
+                            aspectRatio: {
+                                type: 'string',
+                                description: 'Aspect ratio for the generated image',
+                                enum: [
+                                    '1:1',
+                                    '1:4',
+                                    '1:8',
+                                    '2:3',
+                                    '3:2',
+                                    '3:4',
+                                    '4:1',
+                                    '4:3',
+                                    '4:5',
+                                    '5:4',
+                                    '8:1',
+                                    '9:16',
+                                    '16:9',
+                                    '21:9',
+                                ],
+                            },
+                            imageSize: {
+                                type: 'string',
+                                description: 'Image resolution for high-quality output. Specify "1K", "2K", or "4K" when you need specific resolution. Leave unspecified for standard quality.',
+                                enum: ['1K', '2K', '4K'],
+                            },
+                            purpose: {
+                                type: 'string',
+                                description: 'Intended use for the image (e.g., cookbook cover, social media post, presentation slide). Influences lighting, composition, and detail level to match the context.',
+                            },
+                            quality: {
+                                type: 'string',
+                                description: 'Quality preset controlling speed/fidelity tradeoff. Only specify when the user explicitly requests a specific quality level; omit to use the server\'s configured default. "fast": best for drafts and rapid iteration. "balanced": better detail and coherence, moderate latency. "quality": highest fidelity, use for final deliverables where quality matters most.',
+                                enum: ['fast', 'balanced', 'quality'],
+                            },
+                            skipPromptEnhancement: {
+                                type: 'boolean',
+                                description: 'Skip prompt enhancement and use the prompt as-is. Enable when your prompt already contains exact instructions (e.g., multi-image blending) that should not be rewritten. Default: false',
+                            },
+                        },
+                        required: ['prompt'],
+                    },
+                },
+            ],
+        };
+    }
+    /**
+     * Tool execution
+     */
+    async callTool(name, args) {
+        try {
+            if (name === 'generate_image') {
+                return await this.handleGenerateImage(args);
+            }
+            throw new Error(`Unknown tool: ${name}`);
+        }
+        catch (error) {
+            this.logger.error('mcp-server', 'Tool execution failed', error);
+            return ErrorHandler.handleError(error);
+        }
+    }
+    /**
+     * Initialize Gemini clients lazily
+     */
+    async initializeClients() {
+        if (this.structuredPromptGenerator && this.geminiClient)
+            return;
+        const configResult = getConfig();
+        if (!configResult.success) {
+            throw configResult.error;
+        }
+        // Initialize Gemini Text Client for prompt generation
+        if (!this.geminiTextClient) {
+            const textClientResult = createGeminiTextClient(configResult.data);
+            if (!textClientResult.success) {
+                throw textClientResult.error;
+            }
+            this.geminiTextClient = textClientResult.data;
+        }
+        // Initialize Structured Prompt Generator
+        if (!this.structuredPromptGenerator) {
+            this.structuredPromptGenerator = createStructuredPromptGenerator(this.geminiTextClient);
+        }
+        // Initialize Gemini Client for image generation
+        if (!this.geminiClient) {
+            const clientResult = createGeminiClient(configResult.data);
+            if (!clientResult.success) {
+                throw clientResult.error;
+            }
+            this.geminiClient = clientResult.data;
+        }
+        this.logger.info('mcp-server', 'Gemini clients initialized');
+    }
+    /**
+     * Simplified image generation handler
+     */
+    async handleGenerateImage(params) {
+        const result = await ErrorHandler.wrapWithResultType(async () => {
+            // Validate input
+            const validationResult = validateGenerateImageParams(params);
+            if (!validationResult.success) {
+                throw validationResult.error;
+            }
+            // Get configuration
+            const configResult = getConfig();
+            if (!configResult.success) {
+                throw configResult.error;
+            }
+            // Initialize clients
+            await this.initializeClients();
+            // Handle input image if provided
+            let inputImageData;
+            let inputImageMimeType;
+            let inputImagesData;
+            if (params.inputImagePaths && params.inputImagePaths.length > 0) {
+                // Multi-image from file paths: read each file and derive mimeType from extension
+                const extToMime = {
+                    '.jpg': 'image/jpeg',
+                    '.jpeg': 'image/jpeg',
+                    '.png': 'image/png',
+                    '.webp': 'image/webp',
+                    '.gif': 'image/gif',
+                    '.bmp': 'image/bmp',
+                };
+                inputImagesData = await Promise.all(params.inputImagePaths.map(async (filePath) => {
+                    const buffer = await fs.readFile(filePath);
+                    const ext = path.extname(filePath).toLowerCase();
+                    return {
+                        data: buffer.toString('base64'),
+                        mimeType: extToMime[ext] || 'image/jpeg',
+                    };
+                }));
+                inputImageData = inputImagesData[0]?.data;
+                inputImageMimeType = inputImagesData[0]?.mimeType;
+            }
+            else if (params.inputImages && params.inputImages.length > 0) {
+                // Multi-image: strip data URI prefix from each image
+                inputImagesData = params.inputImages.map((img) => ({
+                    data: img.data.replace(/^data:image\/[a-z]+;base64,/, ''),
+                    mimeType: img.mimeType,
+                }));
+                // Use first image for prompt enhancement context
+                inputImageData = inputImagesData[0]?.data;
+                inputImageMimeType = inputImagesData[0]?.mimeType;
+            }
+            else if (params.inputImagePath) {
+                const imageBuffer = await fs.readFile(params.inputImagePath);
+                inputImageData = imageBuffer.toString('base64');
+            }
+            else if (params.inputImage) {
+                // Use base64 input directly, stripping data URI prefix if present
+                inputImageData = params.inputImage.replace(/^data:image\/[a-z]+;base64,/, '');
+                inputImageMimeType = params.inputImageMimeType;
+            }
+            // Generate structured prompt (unless skipped)
+            let structuredPrompt = params.prompt;
+            const shouldSkipEnhancement = params.skipPromptEnhancement ?? configResult.data.skipPromptEnhancement;
+            if (!shouldSkipEnhancement && this.structuredPromptGenerator) {
+                const features = {};
+                if (params.maintainCharacterConsistency !== undefined) {
+                    features.maintainCharacterConsistency = params.maintainCharacterConsistency;
+                }
+                if (params.blendImages !== undefined) {
+                    features.blendImages = params.blendImages;
+                }
+                if (params.useWorldKnowledge !== undefined) {
+                    features.useWorldKnowledge = params.useWorldKnowledge;
+                }
+                if (params.useGoogleSearch !== undefined) {
+                    features.useGoogleSearch = params.useGoogleSearch;
+                }
+                const promptResult = await this.structuredPromptGenerator.generateStructuredPrompt(params.prompt, features, inputImageData, // Pass image data for context-aware prompt generation
+                params.purpose // Pass intended use for purpose-aware prompt generation
+                );
+                if (promptResult.success) {
+                    structuredPrompt = promptResult.data.structuredPrompt;
+                    this.logger.info('mcp-server', 'Structured prompt generated', {
+                        originalLength: params.prompt.length,
+                        structuredLength: structuredPrompt.length,
+                        selectedPractices: promptResult.data.selectedPractices,
+                    });
+                }
+                else {
+                    this.logger.warn('mcp-server', 'Using original prompt', {
+                        error: promptResult.error.message,
+                    });
+                }
+            }
+            else if (shouldSkipEnhancement) {
+                this.logger.info('mcp-server', 'Prompt enhancement skipped (SKIP_PROMPT_ENHANCEMENT=true)');
+            }
+            // Generate image using Gemini API
+            if (!this.geminiClient) {
+                throw new Error('Gemini client not initialized');
+            }
+            const generationResult = await this.geminiClient.generateImage({
+                prompt: structuredPrompt,
+                ...(inputImagesData && { inputImages: inputImagesData }),
+                ...(!inputImagesData && inputImageData && { inputImage: inputImageData }),
+                ...(!inputImagesData && inputImageMimeType && { inputImageMimeType }),
+                ...(params.aspectRatio && { aspectRatio: params.aspectRatio }),
+                ...(params.imageSize && { imageSize: params.imageSize }),
+                ...(params.useGoogleSearch !== undefined && { useGoogleSearch: params.useGoogleSearch }),
+                ...(params.quality !== undefined && { quality: params.quality }),
+            });
+            if (!generationResult.success) {
+                throw generationResult.error;
+            }
+            // Save image file
+            let fileName = params.fileName || this.fileManager.generateFileName();
+            // Auto-append extension if user-provided fileName has no extension
+            if (params.fileName && !path.extname(fileName)) {
+                const mimeToExt = {
+                    'image/png': '.png',
+                    'image/jpeg': '.jpg',
+                    'image/webp': '.webp',
+                    'image/gif': '.gif',
+                    'image/bmp': '.bmp',
+                };
+                fileName += mimeToExt[generationResult.data.metadata.mimeType] || '.png';
+            }
+            const outputPath = path.join(configResult.data.imageOutputDir, fileName);
+            const sanitizedPath = this.securityManager.sanitizeFilePath(outputPath);
+            if (!sanitizedPath.success) {
+                throw sanitizedPath.error;
+            }
+            const saveResult = await this.fileManager.saveImage(generationResult.data.imageData, sanitizedPath.data);
+            if (!saveResult.success) {
+                throw saveResult.error;
+            }
+            // Build response
+            if (params.returnBase64) {
+                const base64Data = generationResult.data.imageData.toString('base64');
+                return this.responseBuilder.buildBase64SuccessResponse(generationResult.data, saveResult.data, base64Data);
+            }
+            return this.responseBuilder.buildSuccessResponse(generationResult.data, saveResult.data);
+        }, 'image-generation');
+        if (result.ok) {
+            return result.value;
+        }
+        return this.responseBuilder.buildErrorResponse(result.error);
+    }
+    /**
+     * Initialize MCP server with tool handlers
+     */
+    initialize() {
+        this.server = new Server({
+            name: this.config.name,
+            version: this.config.version,
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        // Setup tool handlers
+        this.setupHandlers();
+        return this.server;
+    }
+    /**
+     * Setup MCP protocol handlers
+     */
+    setupHandlers() {
+        if (!this.server) {
+            throw new Error('Server not initialized');
+        }
+        // Register tool list handler
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            return this.getToolsList();
+        });
+        // Register tool call handler
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            const result = await this.callTool(name, args);
+            const response = {
+                content: result.content,
+            };
+            if (result.structuredContent) {
+                response.structuredContent = result.structuredContent;
+            }
+            return response;
+        });
+    }
+}
+/**
+ * Factory function to create MCP server
+ */
+export function createMCPServer(config = {}) {
+    return new MCPServerImpl(config);
+}
+//# sourceMappingURL=mcpServer.js.map

package/dist/server/mcpServer.js.map

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

package/dist/server-main.d.ts

@@ -0,0 +1,5 @@
+/**
+ * MCP Image Generator - Server Entry Point
+ */
+export {};
+//# sourceMappingURL=server-main.d.ts.map

package/dist/server-main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-main.d.ts","sourceRoot":"","sources":["../src/server-main.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/server-main.js

@@ -0,0 +1,37 @@
+/**
+ * MCP Image Generator - Server Entry Point
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { MCPServerImpl } from './server/mcpServer.js';
+import { Logger } from './utils/logger.js';
+const logger = new Logger();
+/**
+ * Application startup
+ */
+async function main() {
+    try {
+        logger.info('mcp-startup', 'Starting MCP Image Generator initialization', {
+            nodeVersion: process.version,
+            platform: process.platform,
+            env: process.env['NODE_ENV'] || 'development',
+        });
+        const mcpServerImpl = new MCPServerImpl();
+        const server = mcpServerImpl.initialize();
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        logger.info('mcp-startup', 'Image Generator MCP Server started successfully');
+    }
+    catch (error) {
+        logger.error('mcp-startup', 'Failed to start MCP server', error, {
+            errorType: error?.constructor?.name,
+            stack: error?.stack,
+        });
+        process.exit(1);
+    }
+}
+// Run main function
+main().catch((error) => {
+    logger.error('mcp-startup', 'Fatal error during startup', error);
+    process.exit(1);
+});
+//# sourceMappingURL=server-main.js.map

package/dist/server-main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-main.js","sourceRoot":"","sources":["../src/server-main.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE1C,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAA;AAE3B;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,6CAA6C,EAAE;YACxE,WAAW,EAAE,OAAO,CAAC,OAAO;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,aAAa;SAC9C,CAAC,CAAA;QAEF,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAA;QAEzC,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,EAAE,CAAA;QAEzC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;QAE5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QAE/B,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,iDAAiD,CAAC,CAAA;IAC/E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,4BAA4B,EAAE,KAAc,EAAE;YACxE,SAAS,EAAG,KAAe,EAAE,WAAW,EAAE,IAAI;YAC9C,KAAK,EAAG,KAAe,EAAE,KAAK;SAC/B,CAAC,CAAA;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;AAED,oBAAoB;AACpB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,4BAA4B,EAAE,KAAc,CAAC,CAAA;IACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/types/mcp.d.ts

@@ -0,0 +1,121 @@
+/**
+ * MCP-related type definitions
+ * Defines types related to @modelcontextprotocol/sdk and project-specific types
+ */
+/**
+ * Context method type for image generation metadata
+ */
+/**
+ * Supported aspect ratios for Gemini image generation
+ */
+export type AspectRatio = '1:1' | '1:4' | '1:8' | '2:3' | '3:2' | '3:4' | '4:1' | '4:3' | '4:5' | '5:4' | '8:1' | '9:16' | '16:9' | '21:9';
+/**
+ * Supported image sizes for high-resolution output
+ */
+export type ImageSize = '1K' | '2K' | '4K';
+/**
+ * Quality presets for image generation
+ * - 'fast': Nano Banana 2, fastest generation (default)
+ * - 'balanced': Nano Banana 2 with enhanced thinking, better quality
+ * - 'quality': Nano Banana Pro, highest quality output
+ */
+export type ImageQuality = 'fast' | 'balanced' | 'quality';
+/**
+ * Supported quality preset values
+ */
+export declare const IMAGE_QUALITY_VALUES: readonly ImageQuality[];
+/**
+ * Gemini image generation model identifiers
+ */
+export declare const GEMINI_MODELS: {
+    /** Nano Banana 2 - fast generation with Flash speed */
+    readonly FLASH: "gemini-3.1-flash-image-preview";
+    /** Nano Banana Pro - highest quality output */
+    readonly PRO: "gemini-3-pro-image-preview";
+};
+/**
+ * Parameters for image generation using Gemini API
+ */
+export interface GenerateImageParams {
+    /** Prompt for image generation */
+    prompt: string;
+    /** Optional file name for the generated image (if not specified, generates an auto-named file in IMAGE_OUTPUT_DIR) */
+    fileName?: string;
+    /** Absolute path to input image for editing (optional) */
+    inputImagePath?: string;
+    /** Base64 encoded input image data (optional) */
+    inputImage?: string;
+    /** MIME type of the input image (optional, used with inputImage) */
+    inputImageMimeType?: string;
+    /** Multi-image blending functionality (default: false) */
+    blendImages?: boolean;
+    /** Maintain character consistency across generations (default: false) */
+    maintainCharacterConsistency?: boolean;
+    /** Use world knowledge integration for more accurate context (default: false) */
+    useWorldKnowledge?: boolean;
+    /** Enable Google Search grounding for real-time web information (default: false) */
+    useGoogleSearch?: boolean;
+    /** Aspect ratio for generated image (default: "1:1") */
+    aspectRatio?: AspectRatio;
+    /** Image resolution for high-quality output (e.g., "2K", "4K"). Leave unspecified for standard quality */
+    imageSize?: ImageSize;
+    /** Intended use for the image (e.g., cookbook cover, social media post). Helps tailor visual style and quality */
+    purpose?: string;
+    /** Quality preset for image generation (default: "fast"). Controls model selection and thinking configuration */
+    quality?: ImageQuality;
+    /** Return generated image as base64 data in the response (default: false). Image is always saved to disk regardless */
+    returnBase64?: boolean;
+    /** Multiple input images as base64 for multi-image composition (optional). Cannot be used with other image input params */
+    inputImages?: Array<{
+        data: string;
+        mimeType: string;
+    }>;
+    /** Multiple input image file paths for multi-image composition (optional). Cannot be used with other image input params */
+    inputImagePaths?: string[];
+    /** Skip prompt enhancement and use the prompt as-is (default: false). Useful for multi-image blending where enhancement may overwrite intent */
+    skipPromptEnhancement?: boolean;
+}
+/**
+ * MCP server configuration
+ */
+export interface MCPServerConfig {
+    /** Server name */
+    name: string;
+    /** Version */
+    version: string;
+    /** Default image output directory */
+    defaultOutputDir: string;
+}
+/**
+ * Content types for MCP responses
+ */
+export type McpContent = {
+    type: 'text';
+    text: string;
+};
+/**
+ * MCP Tool Response format
+ */
+export interface McpToolResponse {
+    content: McpContent[];
+    isError?: boolean;
+    structuredContent?: unknown;
+}
+/**
+ * Structured content for successful responses
+ */
+export interface StructuredContent {
+    type: 'resource';
+    resource: {
+        uri: string;
+        name: string;
+        mimeType: string;
+    };
+    metadata: {
+        model: string;
+        processingTime: number;
+        contextMethod: string;
+        timestamp: string;
+    };
+}
+//# sourceMappingURL=mcp.d.ts.map

package/dist/types/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/types/mcp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,MAAM,GACN,MAAM,GACN,MAAM,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAE1C;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAA;AAE1D;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,YAAY,EAI9C,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,uDAAuD;;IAEvD,+CAA+C;;CAEvC,CAAA;AAEV;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,sHAAsH;IACtH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,yEAAyE;IACzE,4BAA4B,CAAC,EAAE,OAAO,CAAA;IACtC,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,oFAAoF;IACpF,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,wDAAwD;IACxD,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,0GAA0G;IAC1G,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,kHAAkH;IAClH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iHAAiH;IACjH,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,uHAAuH;IACvH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,2HAA2H;IAC3H,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACvD,2HAA2H;IAC3H,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,gJAAgJ;IAChJ,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,cAAc;IACd,OAAO,EAAE,MAAM,CAAA;IACf,qCAAqC;IACrC,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,CAAA;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAA;QACb,cAAc,EAAE,MAAM,CAAA;QACtB,aAAa,EAAE,MAAM,CAAA;QACrB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;CACF"}

package/dist/types/mcp.js

@@ -0,0 +1,22 @@
+/**
+ * MCP-related type definitions
+ * Defines types related to @modelcontextprotocol/sdk and project-specific types
+ */
+/**
+ * Supported quality preset values
+ */
+export const IMAGE_QUALITY_VALUES = [
+    'fast',
+    'balanced',
+    'quality',
+];
+/**
+ * Gemini image generation model identifiers
+ */
+export const GEMINI_MODELS = {
+    /** Nano Banana 2 - fast generation with Flash speed */
+    FLASH: 'gemini-3.1-flash-image-preview',
+    /** Nano Banana Pro - highest quality output */
+    PRO: 'gemini-3-pro-image-preview',
+};
+//# sourceMappingURL=mcp.js.map