ultimate-gemini-mcp 1.5.1__py3-none-any.whl → 1.6.0__py3-none-any.whl

src/__init__.py

@@ -7,7 +7,7 @@ A unified MCP server that combines the best features from:
 - Advanced features: batch processing, editing, templates, and more
 """
 
-__version__ = "1.5.1"
+__version__ = "1.6.0"
 __author__ = "Ultimate Gemini MCP"
 
 from .config import get_settings

src/core/validation.py

@@ -124,11 +124,13 @@ def validate_prompts_list(prompts: list[str]) -> None:
 
 
 def sanitize_filename(filename: str) -> str:
-    """Sanitize filename to remove unsafe characters."""
-    # Remove or replace unsafe characters
-    safe_name = re.sub(r'[<>:"/\\|?*\x00-\x1f]', "_", filename)
-    # Remove leading/trailing dots and spaces
-    safe_name = safe_name.strip(". ")
+    """Sanitize filename to remove unsafe and special characters."""
+    # Replace all non-alphanumeric characters (except hyphens) with underscores
+    safe_name = re.sub(r'[^a-zA-Z0-9-]', '_', filename)
+    # Remove multiple consecutive underscores
+    safe_name = re.sub(r'_+', '_', safe_name)
+    # Remove leading/trailing underscores
+    safe_name = safe_name.strip("_")
     # Ensure filename is not empty
     if not safe_name:
         safe_name = "image"

src/services/image_service.py

@@ -54,12 +54,14 @@ class ImageResult:
             raise ImageProcessingError(f"Failed to save image: {e}") from e
 
     def _generate_filename(self) -> str:
-        """Generate descriptive filename."""
+        """Generate clean, short filename."""
         timestamp = self.timestamp.strftime("%Y%m%d_%H%M%S")
-        # Sanitize prompt for filename
-        prompt_snippet = sanitize_filename(self.prompt[:50])
+        # Shorten model name (e.g., gemini-2.5-flash-image -> gemini-flash)
+        model_short = self.model.replace("gemini-2.5-flash-image", "gemini-flash").replace("imagen-4-", "img4-")
+        # Sanitize and shorten prompt (max 30 chars)
+        prompt_snippet = sanitize_filename(self.prompt[:30])
         index_str = f"_{self.index + 1}" if self.index > 0 else ""
-        return f"{self.model}_{timestamp}_{prompt_snippet}{index_str}.png"
+        return f"{model_short}_{timestamp}_{prompt_snippet}{index_str}.png"
 
     def get_size(self) -> int:
         """Get image size in bytes."""

src/tools/batch_generate.py

@@ -133,6 +133,21 @@ def register_batch_generate_tool(mcp_server: Any) -> None:
 
         Returns:
             JSON string with batch results including individual image paths
+
+        IMPORTANT - AI Assistant Instructions:
+        After batch generation completes, you MUST:
+        1. Parse the JSON response to extract file paths from result["results"][i]["images"][0]["path"]
+        2. Show the user a summary of all generated images with their file paths
+        3. Optionally display one or more images using the Read tool
+        4. Let the user know the total count of successful vs failed generations
+
+        Example response to user:
+        "Successfully generated 3 images:
+        1. /path/to/image1.png - [description]
+        2. /path/to/image2.png - [description]
+        3. /path/to/image3.png - [description]"
+
+        DO NOT just say "batch generation completed" without listing the file paths!
         """
         try:
             result = await batch_generate_images(

src/tools/generate_image.py

@@ -217,6 +217,27 @@ def register_generate_image_tool(mcp_server: Any) -> None:
 
         Returns:
             JSON string with generation results and file paths
+
+        IMPORTANT - AI Assistant Instructions:
+        After generating an image, you MUST:
+        1. Parse the JSON response to extract the file path from result["images"][0]["path"]
+        2. Inform the user of the EXACT file path where the image was saved
+        3. Use the Read tool to load and display the image to the user
+        4. Optionally: Use bash to open the image in the default viewer:
+           - macOS: `open /path/to/image.png`
+           - Linux: `xdg-open /path/to/image.png`
+           - Windows: `start /path/to/image.png`
+
+        Example workflow:
+        ```
+        1. Call generate_image tool
+        2. Parse response JSON to get file_path
+        3. Tell user: "Image saved to: /Users/name/gemini_images/image.png"
+        4. Call Read tool with the file_path to display the image
+        5. Optionally call Bash with `open /path/to/image.png` to open in Preview
+        ```
+
+        DO NOT just say "image generated successfully" without showing the path and image!
         """
         try:
             result = await generate_image_tool(

{ultimate_gemini_mcp-1.5.1.dist-info → ultimate_gemini_mcp-1.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ultimate-gemini-mcp
-Version: 1.5.1
+Version: 1.6.0
 Summary: Ultimate image generation MCP server unifying Gemini 2.5 Flash Image and Imagen 4/Fast/Ultra with advanced features
 Project-URL: Homepage, https://github.com/anand-92/ultimate-image-gen-mcp
 Project-URL: Repository, https://github.com/anand-92/ultimate-image-gen-mcp
@@ -201,13 +201,25 @@ Add to your `claude_desktop_config.json`:
       "command": "uvx",
       "args": ["ultimate-gemini-mcp"],
       "env": {
-        "GEMINI_API_KEY": "your-api-key-here"
+        "GEMINI_API_KEY": "your-api-key-here",
+        "OUTPUT_DIR": "/path/to/your/images"
       }
     }
   }
 }
 ```
 
+**Important Notes:**
+
+1. **OUTPUT_DIR is required** when using `uvx` to avoid read-only file system errors. Set it to an absolute path where you want generated images saved:
+   - **macOS**: `"/Users/yourusername/gemini_images"`
+   - **Windows**: `"C:\\Users\\YourUsername\\gemini_images"`
+
+2. **uvx path issues on macOS**: If you get `spawn uvx ENOENT` errors, use the full path to uvx:
+   ```json
+   "command": "/Users/yourusername/.local/bin/uvx"
+   ```
+
 **Config file locations:**
 - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
 - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
@@ -215,10 +227,15 @@ Add to your `claude_desktop_config.json`:
 ### With Claude Code (VS Code)
 
 ```bash
-# Add MCP server to Claude Code
-claude mcp add ultimate-gemini --env GEMINI_API_KEY=your-api-key -- uvx ultimate-gemini-mcp
+# Add MCP server to Claude Code (with required OUTPUT_DIR)
+claude mcp add ultimate-gemini \
+  --env GEMINI_API_KEY=your-api-key \
+  --env OUTPUT_DIR=/path/to/your/images \
+  -- uvx ultimate-gemini-mcp
 ```
 
+**Note**: Replace `/path/to/your/images` with an absolute path to where you want images saved.
+
 ### With Cursor
 
 Add to Cursor's MCP configuration (`.cursor/mcp.json`):
@@ -230,13 +247,16 @@ Add to Cursor's MCP configuration (`.cursor/mcp.json`):
       "command": "uvx",
       "args": ["ultimate-gemini-mcp"],
       "env": {
-        "GEMINI_API_KEY": "your-api-key-here"
+        "GEMINI_API_KEY": "your-api-key-here",
+        "OUTPUT_DIR": "/path/to/your/images"
       }
     }
   }
 }
 ```
 
+**Note**: Set `OUTPUT_DIR` to an absolute path where you want generated images saved.
+
 ## 🎯 Available Models
 
 ### Gemini Models
@@ -412,6 +432,24 @@ View current server configuration.
 
 ## 🐛 Troubleshooting
 
+### "spawn uvx ENOENT" error
+- **Cause**: Claude Desktop cannot find the `uvx` command in its PATH
+- **Solution**: Use the full path to uvx in your config:
+  ```json
+  "command": "/Users/yourusername/.local/bin/uvx"
+  ```
+- Find your uvx location with: `which uvx`
+
+### "[Errno 30] Read-only file system: 'generated_images'"
+- **Cause**: When using `uvx`, the default directory is in a read-only cache location
+- **Solution**: Add `OUTPUT_DIR` to your MCP config:
+  ```json
+  "env": {
+    "GEMINI_API_KEY": "your-key",
+    "OUTPUT_DIR": "/Users/yourusername/gemini_images"
+  }
+  ```
+
 ### "GEMINI_API_KEY not found"
 - Add your API key to `.env` or environment variables
 - Get a free key at [Google AI Studio](https://makersuite.google.com/app/apikey)
@@ -427,6 +465,7 @@ View current server configuration.
 ### Images not saving
 - Check that OUTPUT_DIR exists and is writable
 - Verify you have sufficient disk space
+- Create the directory manually: `mkdir -p /path/to/your/images`
 
 ## 🤝 Contributing
 

{ultimate_gemini_mcp-1.5.1.dist-info → ultimate_gemini_mcp-1.6.0.dist-info}/RECORD

@@ -1,21 +1,21 @@
-src/__init__.py,sha256=nPaNFXizUWdTOnarUMPZPxfvBrhRHj7ifYKXoN8cvn8,435
+src/__init__.py,sha256=DVg45mva4gVQV6mFPilN8aNmhbGo2xlOE1vayS-P8GU,435
 src/server.py,sha256=hyXuhS1h6DN2EiGle8giEPSV1UB3ba7t4do_2olTK3A,5862
 src/config/__init__.py,sha256=hL0recV_ycXBEGCym7BqwyaPCnQHy8o429pBirnBeiA,704
 src/config/constants.py,sha256=ue4dT6wFwCzAgDWvSt8RnbdaoaGHY8c7SViNxI-P73w,1870
 src/config/settings.py,sha256=uTxxblnyqmglz1COd3QxjC2w3o6l51S9MTanP4HBrgE,4257
 src/core/__init__.py,sha256=PQKMAY5eYIEO1oS_hrzeuDgRopl76Wn6NLfhtXBX92I,1200
 src/core/exceptions.py,sha256=NVb4tpwoX_DR-Wp8r73brXvZhEP35SUMyuEis8llFR0,1211
-src/core/validation.py,sha256=JTB6_ft4nN6NHRVD5vOv_q12aPupBrlaNl32jwR2TuE,4758
+src/core/validation.py,sha256=ZlKDcviKQvZLCfOALSIn7sOOt1DxNlchPq0YhJJMqKI,4887
 src/services/__init__.py,sha256=n6FVDj052zvTerDFJSjaiLIycWGePm8Wr6dabbvd9o0,395
 src/services/gemini_client.py,sha256=VPuBPDHhAag_8xBqzMuVIEWVG0BINXOHkwKIALzcFAk,8324
-src/services/image_service.py,sha256=ovYsxDMwqsSiG1YbwBcTBrgmGTA7bdhDF6_jPs9XV_k,7095
+src/services/image_service.py,sha256=6eqp7dukRPfIgHs4sBvfxZ7hsc8E6LrvPx_RdU_h1OM,7300
 src/services/imagen_client.py,sha256=mvwbmtYQHqpKKM36tp8JPZTjxav5eeeist37lRJsv4k,6122
 src/services/prompt_enhancer.py,sha256=J_0s1EVmXdPAhjZPM4hL1vk9YiawqfH_ogF89VrFkW8,4776
 src/tools/__init__.py,sha256=zBfAjFT51LvvD7WXTfDYiyJstRdphr2ChddAmGMZxkI,346
-src/tools/batch_generate.py,sha256=LLrIwVvx-0kZBCiR0tcYnmKi5iYIdV-93ekIQbMrabo,5004
-src/tools/generate_image.py,sha256=BGmplbkqaFvLa8mbJWs-a8v1t5i-Pdep4IZhXHIbisk,8456
-ultimate_gemini_mcp-1.5.1.dist-info/METADATA,sha256=KQptxAop21rrwPfCNAPTM0402UaZjuZLvyC93-75lrA,16130
-ultimate_gemini_mcp-1.5.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-ultimate_gemini_mcp-1.5.1.dist-info/entry_points.txt,sha256=-BeRTT4oR05e-YnF1ZNbNxlaekD4LsWhD-Zy_1dyRnc,56
-ultimate_gemini_mcp-1.5.1.dist-info/licenses/LICENSE,sha256=ilyzUnN0QHYtYGJks-NFUwiniNu08IedLmn_muRqa0o,1480
-ultimate_gemini_mcp-1.5.1.dist-info/RECORD,,
+src/tools/batch_generate.py,sha256=R_aqngSCwg3QAprPHe_0uqH_KJ35G6DoSVA9CU3KkZk,5744
+src/tools/generate_image.py,sha256=wNN1w_KlMpqDP80EhNiDzvEvPozCOFweY9y4w9NtWac,9458
+ultimate_gemini_mcp-1.6.0.dist-info/METADATA,sha256=Za0rXQI56tJxAvDE9gOclcIq4C8lBlY0dAgiu9EMlEo,17588
+ultimate_gemini_mcp-1.6.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+ultimate_gemini_mcp-1.6.0.dist-info/entry_points.txt,sha256=-BeRTT4oR05e-YnF1ZNbNxlaekD4LsWhD-Zy_1dyRnc,56
+ultimate_gemini_mcp-1.6.0.dist-info/licenses/LICENSE,sha256=ilyzUnN0QHYtYGJks-NFUwiniNu08IedLmn_muRqa0o,1480
+ultimate_gemini_mcp-1.6.0.dist-info/RECORD,,