universal-mcp-applications 0.1.12__py3-none-any.whl → 0.1.14__py3-none-any.whl

universal_mcp/applications/google_gemini/app.py

@@ -40,10 +40,11 @@ class GoogleGeminiApp(APIApplication):
         prompt: Annotated[str, "The prompt to generate text from"],
         model: str = "gemini-2.5-flash",
     ) -> str:
-        """Generates text using the Google Gemini model.
+        """Generates text using the Google Gemini model based on a given prompt.
+        This tool is suitable for various natural language processing tasks such as content generation, summarization, translation, and question answering.
 
         Args:
-            prompt (str): The prompt to generate text from.
+            prompt (str): The text prompt or instruction for the model to follow. For example: "Write a short story about a robot who learns to love."
             model (str, optional): The Gemini model to use for text generation. Defaults to "gemini-2.5-flash".
 
         Returns:
@@ -53,11 +54,8 @@ class GoogleGeminiApp(APIApplication):
             ValueError: If the API key is not found in the integration credentials.
             Exception: If the underlying client or API call fails.
 
-        Example:
-            response = app.generate_text("Tell me a joke.")
-
         Tags:
-            important
+            text, generate, llm, important
         """
         response = self.genai_client.models.generate_content(
             contents=prompt, model=model
@@ -71,20 +69,30 @@ class GoogleGeminiApp(APIApplication):
         model: str = "gemini-2.5-flash-image-preview",
     ) -> list:
         """
-        Generates an image using the Google Gemini model and returns a list of results.
-        Each result is a dict with either 'text' or 'image_bytes' (raw image data).
+        Generates an image based on a text prompt and an optional reference image using the Google Gemini model.
+        This tool is ideal for creating visual content or modifying existing images based on natural language descriptions.
+        It returns a dictionary containing the generated image data (base64 encoded), its MIME type, a suggested file name, and any accompanying text.
 
         Args:
-            prompt (str): The prompt to generate image from.
-            image (str, optional): The reference image path url.
+            prompt (str): The descriptive text prompt to guide the image generation. For example: "A futuristic city at sunset with flying cars."
+            image (str, optional): An optional URL or local file path to a reference image. This image will be used as a basis for the generation.
             model (str, optional): The Gemini model to use for image generation. Defaults to "gemini-2.5-flash-image-preview".
 
-
         Returns:
-            list: A list of dicts, each containing either 'text' or 'image_bytes'.
+            dict: A dictionary containing:
+                - 'type' (str): Always "image".
+                - 'data' (str): The base64 encoded image data.
+                - 'mime_type' (str): The MIME type of the image (e.g., "image/png").
+                - 'file_name' (str): A suggested file name for the generated image.
+                - 'text' (str): Any accompanying text generated by the model.
+
+        Raises:
+            requests.exceptions.RequestException: If there's an issue fetching a remote reference image.
+            FileNotFoundError: If a local reference image path is invalid.
+            Exception: If the underlying Gemini API call fails.
 
         Tags:
-            important
+            image, generate, vision, important
         """
         # The Gemini API is synchronous, so run in a thread
         contents = [prompt]
@@ -128,17 +136,26 @@ class GoogleGeminiApp(APIApplication):
         prompt: Annotated[str, "The prompt to generate audio from"],
         model: str = "gemini-2.5-flash-preview-tts",
     ) -> str:
-        """Generates audio using the Google Gemini model and returns the uploaded audio URL.
+        """Generates audio from a given text prompt using the Google Gemini model's Text-to-Speech (TTS) capabilities.
+        This tool is useful for converting text into spoken audio, which can be used for voiceovers, accessibility features, or interactive applications.
+        It returns a dictionary containing the generated audio data (base64 encoded), its MIME type, and a suggested file name.
 
         Args:
-            prompt (str): The prompt to generate audio from.
+            prompt (str): The text to be converted into speech. For example: "Hello, how can I help you today?"
             model (str, optional): The Gemini model to use for audio generation. Defaults to "gemini-2.5-flash-preview-tts".
 
         Returns:
-            str: The URL of the uploaded audio file.
+            dict: A dictionary containing:
+                - 'type' (str): Always "audio".
+                - 'data' (str): The base64 encoded audio data.
+                - 'mime_type' (str): The MIME type of the audio (e.g., "audio/wav").
+                - 'file_name' (str): A suggested file name for the generated audio.
+
+        Raises:
+            Exception: If the underlying Gemini API call fails or there's an issue during audio processing.
 
         Tags:
-            important
+            audio, generate, tts, speech, important
         """
 
         # Set up the wave file to save the output: