mcp-image 0.5.6 → 0.7.0

package/README.md

@@ -7,7 +7,7 @@ A powerful MCP (Model Context Protocol) server that enables AI assistants to gen
 ## ✨ Features
 
 - **AI-Powered Image Generation**: Create images from text prompts using Gemini 3 Pro Image (Nano Banana Pro)
-- **Intelligent Prompt Enhancement**: Automatically optimizes your prompts using Gemini 2.0 Flash for superior image quality
+- **Intelligent Prompt Enhancement**: Automatically optimizes your prompts using Gemini 2.5 Flash for superior image quality
   - Adds photographic and artistic details
   - Enriches lighting, composition, and atmosphere descriptions
   - Preserves your intent while maximizing generation quality
@@ -26,6 +26,53 @@ A powerful MCP (Model Context Protocol) server that enables AI assistants to gen
 - **Multiple Output Formats**: PNG, JPEG, WebP support
 - **File Output**: Images are saved as files for easy access and integration
 
+## 🎨 Agent Skill: Image Generation Prompt Guide
+
+This project also provides a standalone **Agent Skill** that teaches AI assistants to write better image generation prompts — no MCP server or API key required.
+
+### What it does
+
+> **Note:** This skill does not generate images itself — it teaches your AI assistant to write better prompts. Your AI tool must already have built-in image generation capabilities (e.g., Cursor's image generation feature).
+
+A reference guide that AI assistants use to improve image generation prompts based on the **Subject-Context-Style** framework. Works with any image model (Gemini, DALL-E, Flux, Stable Diffusion, etc.).
+
+Covers:
+
+- **Prompt structure** — How to build prompts around Subject, Context, and Style
+- **Visual details** — Lighting, textures, camera angles, atmosphere, text in images
+- **Advanced features** — Character consistency, multi-element composition, factual accuracy, purpose-specific output
+- **Image editing** — How to describe edits while keeping the original look intact
+
+### Install
+
+```bash
+npx mcp-image skills install --path <target-directory>
+```
+
+The skill will be placed at `<path>/image-generation/SKILL.md`. Specify the skills directory for your AI tool:
+
+```bash
+# Cursor
+npx mcp-image skills install --path ~/.cursor/skills
+
+# Codex
+npx mcp-image skills install --path ~/.codex/skills
+
+# Claude Code
+npx mcp-image skills install --path ~/.claude/skills
+```
+
+### When to use the Skill vs the MCP server
+
+| | MCP Server | Agent Skill |
+|---|---|---|
+| **Use when** | Your AI tool does not have built-in image generation | Your AI tool already generates images natively |
+| **Requires** | Gemini API key | Nothing |
+| **What it does** | Generates images via API | Teaches the AI to write better prompts |
+| **Works with** | MCP-compatible tools | Any tool supporting the [Agent Skills](https://agentskills.io) standard |
+
+---
+
 ## 🔧 Prerequisites
 
 - **Node.js** 20 or higher
@@ -162,7 +209,7 @@ The system automatically enhances this to include rich details about lighting, m
 ### `generate_image` Tool
 
 The MCP server exposes a single tool for all image operations. Internally, it uses a two-stage process:
-1. **Prompt Optimization**: Gemini 2.0 Flash analyzes and enriches your prompt
+1. **Prompt Optimization**: Gemini 2.5 Flash analyzes and enriches your prompt
 2. **Image Generation**: Gemini 3 Pro Image creates the final image
 
 #### Parameters
@@ -229,7 +276,7 @@ The MCP server exposes a single tool for all image operations. Internally, it us
 ## 💰 Usage Notes
 
 - This MCP server uses the paid Gemini API for both prompt optimization and image generation
-  - Gemini 2.0 Flash for intelligent prompt enhancement (minimal token usage)
+  - Gemini 2.5 Flash for intelligent prompt enhancement (minimal token usage)
   - Gemini 3 Pro Image for actual image generation
 - Check current pricing and rate limits at [Google AI Studio](https://aistudio.google.com/)
 - Monitor your API usage to avoid unexpected charges

package/bin/install-skills.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+'use strict'
+
+const { cpSync, existsSync, mkdirSync } = require('node:fs')
+const { dirname, resolve } = require('node:path')
+
+const SKILLS_SOURCE = resolve(__dirname, '..', 'skills', 'image-generation')
+const SKILL_DIR_NAME = 'image-generation'
+
+function printHelp() {
+  console.log(`
+Image Generation Skills Installer
+
+Usage:
+  npx mcp-image skills install --path <path>
+
+Options:
+  --path <path>    Install skills to the specified directory.
+                   The skill will be placed at <path>/${SKILL_DIR_NAME}/
+
+  --help, -h       Show this help message
+
+Examples:
+  npx mcp-image skills install --path ~/.claude/skills
+  npx mcp-image skills install --path ./.claude/skills
+  npx mcp-image skills install --path /custom/path
+`)
+}
+
+function parseArgs(args) {
+  const options = { path: undefined, help: false }
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i]
+
+    switch (arg) {
+      case '--help':
+      case '-h':
+        options.help = true
+        break
+
+      case '--path': {
+        const pathArg = args[i + 1]
+        if (!pathArg) {
+          console.error('Error: --path requires a path argument')
+          process.exit(1)
+        }
+        options.path = pathArg
+        i++
+        break
+      }
+
+      default:
+        if (arg && arg.startsWith('-')) {
+          console.error(`Unknown option: ${arg}`)
+          process.exit(1)
+        }
+    }
+  }
+
+  return options
+}
+
+function install(targetPath) {
+  if (!existsSync(SKILLS_SOURCE)) {
+    console.error(`Error: Skills source not found at ${SKILLS_SOURCE}`)
+    process.exit(1)
+  }
+
+  const targetDir = dirname(targetPath)
+  if (!existsSync(targetDir)) {
+    mkdirSync(targetDir, { recursive: true })
+    console.log(`Created directory: ${targetDir}`)
+  }
+
+  cpSync(SKILLS_SOURCE, targetPath, { recursive: true })
+  console.log(`Installed skills to: ${targetPath}`)
+}
+
+function run(args) {
+  if (args.length === 0) {
+    printHelp()
+    process.exit(0)
+  }
+
+  const options = parseArgs(args)
+
+  if (options.help) {
+    printHelp()
+    process.exit(0)
+  }
+
+  if (!options.path) {
+    console.error('Error: --path is required')
+    console.error('Run "npx mcp-image skills install --help" for usage information.')
+    process.exit(1)
+  }
+
+  const targetPath = resolve(options.path, SKILL_DIR_NAME)
+
+  console.log('Installing image-generation skills...')
+  console.log(`Path: ${targetPath}`)
+  console.log()
+
+  install(targetPath)
+
+  console.log()
+  console.log('Installation complete!')
+  console.log()
+  console.log('Installed files:')
+  console.log('  - image-generation/SKILL.md')
+}
+
+module.exports = { run }

package/dist/api/geminiTextClient.d.ts

@@ -15,6 +15,10 @@ export interface GenerationConfig {
     timeout?: number;
     systemInstruction?: string;
     inputImage?: string;
+    topP?: number;
+    topK?: number;
+    frequencyPenalty?: number;
+    presencePenalty?: number;
 }
 /**
  * Interface for Gemini Text Client - pure API client

package/dist/api/geminiTextClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"geminiTextClient.d.ts","sourceRoot":"","sources":["../../src/api/geminiTextClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,YAAY,CACV,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC,CAAA;IAEzD;;;OAGG;IACH,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC,CAAA;CAC9E;AA8QD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAY/F"}
+{"version":3,"file":"geminiTextClient.d.ts","sourceRoot":"","sources":["../../src/api/geminiTextClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,YAAY,CACV,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC,CAAA;IAEzD;;;OAGG;IACH,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC,CAAA;CAC9E;AAiSD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAY/F"}

package/dist/api/geminiTextClient.js

@@ -22,7 +22,7 @@ const DEFAULT_GENERATION_CONFIG = {
  */
 class GeminiTextClientImpl {
     constructor(config) {
-        this.modelName = 'gemini-2.0-flash';
+        this.modelName = 'gemini-2.5-flash';
         this.genai = new genai_1.GoogleGenAI({
             apiKey: config.geminiApiKey,
         });
@@ -80,14 +80,21 @@ class GeminiTextClientImpl {
                 // Text-only request
                 contents = prompt;
             }
-            // Use the updated API structure for @google/genai v1.17.0+
+            // Use the updated API structure for @google/genai v1.42.0+
             const apiCall = this.genai.models.generateContent({
                 model: this.modelName,
                 contents,
-                ...(config.systemInstruction && { systemInstruction: config.systemInstruction }),
-                generationConfig: {
+                config: {
+                    ...(config.systemInstruction !== undefined && {
+                        systemInstruction: config.systemInstruction,
+                    }),
                     temperature: config.temperature || 0.7,
                     maxOutputTokens: config.maxTokens || 8192,
+                    topP: config.topP ?? 0.95,
+                    topK: config.topK ?? 40,
+                    thinkingConfig: {
+                        thinkingBudget: 0,
+                    },
                 },
             });
             const response = await Promise.race([apiCall, timeoutPromise]);

package/dist/api/geminiTextClient.js.map

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

package/dist/bin/install-skills.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Image Generation Skills Installer
+ *
+ * Installs image-generation skills to the specified path.
+ *
+ * Usage:
+ *   npx mcp-image skills install --path <path>
+ *   npx mcp-image skills install --path ~/.claude/skills
+ */
+/**
+ * Run the skills installer with the given arguments
+ */
+export declare function run(args: string[]): void;
+//# sourceMappingURL=install-skills.d.ts.map

package/dist/bin/install-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-skills.d.ts","sourceRoot":"","sources":["../../src/bin/install-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsFH;;GAEG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAiCxC"}

package/dist/bin/install-skills.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * Image Generation Skills Installer
+ *
+ * Installs image-generation skills to the specified path.
+ *
+ * Usage:
+ *   npx mcp-image skills install --path <path>
+ *   npx mcp-image skills install --path ~/.claude/skills
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+// Skills source directory (relative to dist/bin when compiled)
+// dist/bin/install-skills.js -> skills/image-generation
+const SKILLS_SOURCE = (0, node_path_1.resolve)(__dirname, '..', '..', 'skills', 'image-generation');
+const SKILL_DIR_NAME = 'image-generation';
+function printHelp() {
+    console.log(`
+Image Generation Skills Installer
+
+Usage:
+  npx mcp-image skills install --path <path>
+
+Options:
+  --path <path>    Install skills to the specified directory.
+                   The skill will be placed at <path>/image-generation/
+
+  --help, -h       Show this help message
+
+Examples:
+  npx mcp-image skills install --path ~/.claude/skills
+  npx mcp-image skills install --path ./.claude/skills
+  npx mcp-image skills install --path /custom/path
+`);
+}
+function parseArgs(args) {
+    const options = { help: false };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--help':
+            case '-h':
+                options.help = true;
+                break;
+            case '--path': {
+                const pathArg = args[i + 1];
+                if (!pathArg) {
+                    console.error('Error: --path requires a path argument');
+                    process.exit(1);
+                }
+                options.path = pathArg;
+                i++;
+                break;
+            }
+            default:
+                if (arg?.startsWith('-')) {
+                    console.error(`Unknown option: ${arg}`);
+                    process.exit(1);
+                }
+        }
+    }
+    return options;
+}
+function install(targetPath) {
+    if (!(0, node_fs_1.existsSync)(SKILLS_SOURCE)) {
+        console.error(`Error: Skills source not found at ${SKILLS_SOURCE}`);
+        process.exit(1);
+    }
+    const targetDir = (0, node_path_1.dirname)(targetPath);
+    if (!(0, node_fs_1.existsSync)(targetDir)) {
+        (0, node_fs_1.mkdirSync)(targetDir, { recursive: true });
+        console.log(`Created directory: ${targetDir}`);
+    }
+    (0, node_fs_1.cpSync)(SKILLS_SOURCE, targetPath, { recursive: true });
+    console.log(`Installed skills to: ${targetPath}`);
+}
+/**
+ * Run the skills installer with the given arguments
+ */
+function run(args) {
+    if (args.length === 0) {
+        printHelp();
+        process.exit(0);
+    }
+    const options = parseArgs(args);
+    if (options.help) {
+        printHelp();
+        process.exit(0);
+    }
+    if (!options.path) {
+        console.error('Error: --path is required');
+        console.error('Run "npx mcp-image skills install --help" for usage information.');
+        process.exit(1);
+    }
+    const targetPath = (0, node_path_1.resolve)(options.path, SKILL_DIR_NAME);
+    console.log('Installing image-generation skills...');
+    console.log(`Path: ${targetPath}`);
+    console.log();
+    install(targetPath);
+    console.log();
+    console.log('Installation complete!');
+    console.log();
+    console.log('Installed files:');
+    console.log('  - image-generation/SKILL.md');
+}
+//# sourceMappingURL=install-skills.js.map

package/dist/bin/install-skills.js.map

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

package/dist/business/structuredPromptGenerator.js

@@ -28,9 +28,9 @@ Structure your enhancement around three core elements:
    - Mood and emotional tone of the scene
 
 3. STYLE (How): The visual treatment
-   - Artistic or photographic approach
+   - Artistic or photographic approach: reference specific artists, movements, or styles
    - Lighting design: direction, quality, color temperature, shadows
-   - Camera/lens choices if relevant (focal length, depth of field, angle)
+   - Camera/lens choices: specify focal length, aperture, and shooting angle when photographic
 
 Core principles:
 - Preserve the user's original intent while enhancing detail
@@ -72,7 +72,7 @@ class StructuredPromptGeneratorImpl {
             // Generate structured prompt using Gemini 2.0 Flash via pure API call
             const config = {
                 temperature: 0.7,
-                maxTokens: 2000,
+                maxTokens: 1000,
                 systemInstruction,
                 ...(inputImageData && { inputImage: inputImageData }), // Only include if available
             };

package/dist/index.d.ts

@@ -1,4 +1,11 @@
 #!/usr/bin/env node
+/**
+ * MCP Image Generator - Entry Point Router
+ *
+ * Routes to:
+ * - skills install  → bin/install-skills.js
+ * - (default)       → MCP server startup
+ */
 export { createMCPServer, MCPServerImpl } from './server/mcpServer';
 export type { GenerateImageParams, MCPServerConfig } from './types/mcp';
 export type { GeneratedImageResult } from './api/geminiClient';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AA+CA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACnE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AACvE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG;AAoBH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACnE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AACvE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -1,45 +1,32 @@
 #!/usr/bin/env node
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MCPServerImpl = exports.createMCPServer = void 0;
-const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
-/**
- * MCP Image Generator entry point
- * MCP server startup process
- */
-const mcpServer_1 = require("./server/mcpServer");
-const logger_1 = require("./utils/logger");
-const logger = new logger_1.Logger();
 /**
- * Application startup
+ * MCP Image Generator - Entry Point Router
+ *
+ * Routes to:
+ * - skills install  → bin/install-skills.js
+ * - (default)       → MCP server 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 mcpServer_1.MCPServerImpl();
-        const server = mcpServerImpl.initialize();
-        const transport = new stdio_js_1.StdioServerTransport();
-        await server.connect(transport);
-        logger.info('mcp-startup', 'Image Generator MCP Server started successfully');
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPServerImpl = exports.createMCPServer = void 0;
+const node_path_1 = require("node:path");
+const args = process.argv.slice(2);
+if (args[0] === 'skills') {
+    if (args[1] === 'install') {
+        const { run } = require((0, node_path_1.resolve)(__dirname, '..', 'bin', 'install-skills.js'));
+        run(args.slice(2));
+        process.exit(0);
     }
-    catch (error) {
-        logger.error('mcp-startup', 'Failed to start MCP server', error, {
-            errorType: error?.constructor?.name,
-            stack: error?.stack,
-        });
+    else {
+        console.error('Unknown skills subcommand. Usage: npx mcp-image skills install --path <path>');
+        console.error('Run "npx mcp-image skills install --help" for more information.');
         process.exit(1);
     }
 }
-// Run main function
-main().catch((error) => {
-    logger.error('mcp-startup', 'Fatal error during startup', error);
-    process.exit(1);
-});
-var mcpServer_2 = require("./server/mcpServer");
-Object.defineProperty(exports, "createMCPServer", { enumerable: true, get: function () { return mcpServer_2.createMCPServer; } });
-Object.defineProperty(exports, "MCPServerImpl", { enumerable: true, get: function () { return mcpServer_2.MCPServerImpl; } });
+else {
+    require('./server-main');
+}
+var mcpServer_1 = require("./server/mcpServer");
+Object.defineProperty(exports, "createMCPServer", { enumerable: true, get: function () { return mcpServer_1.createMCPServer; } });
+Object.defineProperty(exports, "MCPServerImpl", { enumerable: true, get: function () { return mcpServer_1.MCPServerImpl; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;AAEA,wEAAgF;AAChF;;;GAGG;AACH,kDAAkD;AAClD,2CAAuC;AAEvC,MAAM,MAAM,GAAG,IAAI,eAAM,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,yBAAa,EAAE,CAAA;QAEzC,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,EAAE,CAAA;QAEzC,MAAM,SAAS,GAAG,IAAI,+BAAoB,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;AAEF,gDAAmE;AAA1D,4GAAA,eAAe,OAAA;AAAE,0GAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAEA;;;;;;GAMG;;;AAEH,yCAAmC;AAEnC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAElC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;IACzB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAA,mBAAO,EAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAA;QAC7E,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,8EAA8E,CAAC,CAAA;QAC7F,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAA;QAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,eAAe,CAAC,CAAA;AAC1B,CAAC;AAED,gDAAmE;AAA1D,4GAAA,eAAe,OAAA;AAAE,0GAAA,aAAa,OAAA"}

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,39 @@
+"use strict";
+/**
+ * MCP Image Generator - Server Entry Point
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const mcpServer_1 = require("./server/mcpServer");
+const logger_1 = require("./utils/logger");
+const logger = new logger_1.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 mcpServer_1.MCPServerImpl();
+        const server = mcpServerImpl.initialize();
+        const transport = new stdio_js_1.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,wEAAgF;AAChF,kDAAkD;AAClD,2CAAuC;AAEvC,MAAM,MAAM,GAAG,IAAI,eAAM,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,yBAAa,EAAE,CAAA;QAEzC,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,EAAE,CAAA;QAEzC,MAAM,SAAS,GAAG,IAAI,+BAAoB,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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-image",
   "mcpName": "io.github.shinpr/mcp-image",
-  "version": "0.5.6",
+  "version": "0.7.0",
   "description": "MCP server for AI image generation",
   "main": "dist/index.js",
   "bin": {
@@ -21,7 +21,9 @@
     "claude-code",
     "cursor",
     "codex",
-    "typescript"
+    "typescript",
+    "agent-skills",
+    "skills"
   ],
   "author": "Shinsuke Kagawa",
   "license": "MIT",
@@ -34,7 +36,9 @@
     "!dist/**/*.test.js",
     "!dist/**/*.test.d.ts",
     "!dist/__tests__",
-    "!dist/tests"
+    "!dist/tests",
+    "bin",
+    "skills"
   ],
   "scripts": {
     "build": "tsc && tsc-alias",
@@ -58,7 +62,7 @@
     "test:safe": "npm test && npm run cleanup:processes"
   },
   "dependencies": {
-    "@google/genai": "^1.30.0",
+    "@google/genai": "^1.42.0",
     "@modelcontextprotocol/sdk": "^1.0.0"
   },
   "devDependencies": {

package/skills/image-generation/SKILL.md

@@ -0,0 +1,131 @@
+---
+name: image-generation
+description: Enhances image generation prompts using Subject-Context-Style structure and best practices. Use this skill when generating images, creating illustrations, photos, visual assets, editing images, or crafting prompts for image generation.
+---
+
+# Image Generation Prompt Best Practices
+
+## Prompt Structure
+
+Enhance every image generation prompt around three core elements:
+
+### 1. SUBJECT (What)
+
+The main focus of the image.
+
+- Physical characteristics: textures, materials, colors, scale
+- Actions, poses, expressions if applicable
+- Distinctive features that define the subject
+
+### 2. CONTEXT (Where/When)
+
+The environment and conditions.
+
+- Setting, background, spatial relationships (foreground, midground, background)
+- Time of day, weather, atmospheric conditions
+- Mood and emotional tone of the scene
+
+### 3. STYLE (How)
+
+The visual treatment.
+
+- Artistic or photographic approach: reference specific artists, movements, or styles
+- Lighting design: direction, quality, color temperature, shadows
+- Camera/lens choices: specify focal length, aperture, and shooting angle when photographic
+
+## Core Principles
+
+- **Preserve intent** — Enrich the user's original vision, never override it
+- **Positive descriptions only** — Describe what should be present; rephrase any exclusion as an inclusion
+- **Specific over vague** — "golden hour sunlight at 15° angle" beats "nice lighting"
+- **Natural flow** — Weave elements into a single flowing description, not a bullet list
+
+## Enhancement Patterns
+
+### Hyper-Specific Details
+
+Add concrete visual details where the user left gaps:
+
+- Lighting → direction, quality, color temperature, shadow behavior
+- Textures → surface materials, weathering, reflectivity
+- Atmosphere → particulates, humidity, depth haze
+- Scale → relative sizes, distances, proportions
+
+### Camera Control Terminology
+
+When a photographic look is appropriate:
+
+- Lens type: "shot with 85mm portrait lens", "wide-angle 24mm"
+- Aperture: "shallow depth of field at f/1.8", "deep focus at f/11"
+- Angle: "low angle emphasizing height", "bird's eye view"
+- Motion: "motion blur on the paws", "frozen mid-action"
+
+### Atmospheric Enhancement
+
+Convey mood through environmental details:
+
+- Emotional tone: "serene", "ominous", "jubilant"
+- Light quality: "dappled shadows", "harsh midday sun", "soft diffused overcast"
+- Weather/air: "morning mist", "dust particles in a sunbeam"
+
+### Text in Images
+
+When the image should contain readable text (signs, labels, titles, typography):
+
+- Specify the exact text content in quotes: `"OPEN 24 HOURS" in bold sans-serif`
+- Describe visual treatment: font style, weight, size relative to the scene
+- Define placement and integration: "centered on the storefront awning", "hand-lettered on the chalkboard"
+
+## Feature Patterns
+
+### Character Consistency
+
+When the same character must be recognizable across multiple images:
+
+- Include **at least 3 recognizable visual markers** (distinctive scar, signature clothing, unique hairstyle, characteristic accessory)
+- Use anchoring words: "distinctive", "signature", "always wears", "always has"
+- Be specific: "round tortoiseshell glasses" not just "glasses"
+
+### Compositional Integration (Multi-Element Blending)
+
+When combining multiple visual elements in one scene:
+
+- Define spatial relationships with proportions: "foreground (40% of frame)", "midground", "background"
+- Use integration language: "seamlessly blending", "harmoniously composed", "naturally integrated"
+- Specify relative scale and interaction between elements
+
+### Real-World Accuracy
+
+When depicting real places, cultures, or historical elements:
+
+- Use specific terminology: "traditional Edo-period architecture", "authentic Moroccan zellige tilework"
+- Include culturally accurate details
+- Reference geographical or historical specifics
+
+### Purpose-Driven Enhancement
+
+Tailor the prompt to the intended use:
+
+| Purpose | Emphasis |
+|---------|----------|
+| Product photo | Clean background, studio lighting, commercial appeal |
+| UI mockup | Flat design elements, consistent spacing, screen-appropriate |
+| Presentation slide | Bold composition, clear focal point, text-friendly layout |
+| Social media | Eye-catching, vibrant, crop-friendly aspect ratio |
+| Book/album cover | Typography space, dramatic mood, symbolic elements |
+
+## Image Editing
+
+When modifying an existing image:
+
+- **Preserve** the original's core characteristics: color palette, lighting style, composition
+- Use anchoring phrases: "maintain the existing...", "preserve the original...", "keep the same..."
+- Be specific about what to change vs what to keep unchanged
+- Describe modifications relative to the existing image, not from scratch
+
+## Example
+
+**Input:** "A happy dog in a park"
+
+**Enhanced:** "Golden retriever mid-leap catching a red frisbee, ears flying, tongue out in joy, in a sunlit urban park. Soft morning light filtering through oak trees creates dappled shadows on emerald grass. Background shows families on picnic blankets, slightly out of focus. Shot from low angle emphasizing the dog's athletic movement, with motion blur on the paws suggesting speed."
+