universal-mcp-applications 0.1.17__py3-none-any.whl → 0.1.33__py3-none-any.whl

universal_mcp/applications/google_gemini/README.md

@@ -9,17 +9,6 @@ This is automatically generated from OpenAPI schema for the GoogleGeminiApp API.
 
 | Tool | Description |
 |------|-------------|
-| `fetch_model` | Retrieves the configuration details of current model via a GET request. |
-| `fetch_models` | Retrieves a paginated list of available models, supporting page size and token parameters for result navigation. |
-| `text_only_input` | Generates content using the Gemini 1.5 Flash model via POST request, |
-| `generate_atext_stream` | Generates a streaming response from the Gemini 1.5 Flash model for multimodal input content. |
-| `resumable_upload_request` | Initiates a file upload by sending file metadata. |
-| `prompt_document` | Generates content using the Gemini model with document context. |
-| `text_tokens` | Calculates the number of tokens and billable characters for input content using a gemini-2.0-flash. |
-| `fetch_tuned_models` | Retrieves a list of tuned models at the specified page size using the GET method. |
-| `create_atuned_model` | Creates a tuned model using the "POST" method at the "/v1beta/tunedModels" endpoint and returns a response upon successful creation. |
-| `prompt_the_tuned_model` | Generates content using a specified tuned model defined at path "/v1beta/{tunedModel}:generateContent" by sending a POST request. |
-| `delete_tuned_model` | Deletes a specified tuned model and returns a success status upon removal. |
-| `generate_embeddings` | Generates a text embedding vector from input text using the specified Gemini Embedding model, allowing for semantic analysis and comparison of textual content. |
-| `batch_embeddings` | Generates batch embeddings for a list of text inputs using the "gemini-embedding-exp-03-07" model via a POST request to the "/v1beta/models/text-embedding-004:batchEmbedContents" endpoint. |
-| `discovery_document` | Retrieves discovery metadata for REST APIs, including available endpoints and parameters, based on the specified version. |
+| `generate_text` | Generates text using the Google Gemini model based on a given prompt. |
+| `generate_image` | Generates an image based on a text prompt and an optional reference image using the Google Gemini model. |
+| `generate_audio` | Generates audio from a given text prompt using the Google Gemini model's Text-to-Speech (TTS) capabilities. |

universal_mcp/applications/google_gemini/app.py

@@ -7,11 +7,8 @@ from typing import Annotated
 
 from google import genai
 from google.genai import types
-from loguru import logger
 from PIL import Image
-
 from universal_mcp.applications.application import APIApplication
-from universal_mcp.applications.file_system.app import FileSystemApp
 from universal_mcp.integrations import Integration
 
 
@@ -65,9 +62,9 @@ class GoogleGeminiApp(APIApplication):
     async def generate_image(
         self,
         prompt: Annotated[str, "The prompt to generate image from"],
-        image: Annotated[str, "The reference image path"] | None = None,
+        images: Annotated[list[str], "The reference image URLs"] | None = None, 
         model: str = "gemini-2.5-flash-image-preview",
-    ) -> list:
+    ) -> dict:
         """
         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.
@@ -75,7 +72,7 @@ class GoogleGeminiApp(APIApplication):
 
         Args:
             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.
+            images (list[str], optional): An optional list of URLs to reference images. These images 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:
@@ -96,16 +93,17 @@ class GoogleGeminiApp(APIApplication):
         """
         # The Gemini API is synchronous, so run in a thread
         contents = [prompt]
-        if image:
-            if image.startswith(("http://", "https://")):
-                import requests
-
-                response = requests.get(image)
-                response.raise_for_status()
-                image = Image.open(io.BytesIO(response.content))
-            else:
-                image = Image.open(image)
-            contents.append(image)
+        if images:
+            for image in images:
+                if image.startswith(("http://", "https://")):
+                    import requests
+
+                    response = requests.get(image)
+                    response.raise_for_status()
+                    image = Image.open(io.BytesIO(response.content))
+                else:
+                    image = Image.open(image)
+                contents.append(image)
         response = self.genai_client.models.generate_content(
             model=model,
             contents=contents,
@@ -215,10 +213,9 @@ class GoogleGeminiApp(APIApplication):
 
 async def test_google_gemini():
     app = GoogleGeminiApp()
-    result = await app.generate_image(
+    await app.generate_image(
         "A beautiful women potrait with red green hair color"
     )
-    print(result)
 
 
 if __name__ == "__main__":

universal_mcp/applications/google_mail/README.md

@@ -9,23 +9,23 @@ This is automatically generated from OpenAPI schema for the GoogleMailApp API.
 
 | Tool | Description |
 |------|-------------|
-| `send_email` | Sends an email using the Gmail API and returns a confirmation or error message. |
-| `create_draft` | Creates a draft email message in Gmail using the Gmail API and returns a confirmation status. |
-| `send_draft` | Sends an existing draft email using the Gmail API and returns a confirmation message. |
-| `get_draft` | Retrieves and formats a specific draft email from Gmail by its ID |
-| `list_drafts` | Retrieves and formats a list of email drafts from the user's Gmail mailbox with optional filtering and pagination. |
-| `get_message` | Retrieves and formats a specific email message from Gmail API by its ID, including sender, recipient, date, subject, and full message body content. |
-| `list_messages` | Retrieves and formats a list of messages from the user's Gmail mailbox with optional filtering and pagination support. |
-| `list_labels` | Retrieves and formats a list of all labels (both system and user-created) from the user's Gmail account, organizing them by type and sorting them alphabetically. |
-| `create_label` | Creates a new Gmail label with specified visibility settings and returns creation status details. |
-| `get_profile` | Retrieves and formats the user's Gmail profile information including email address, message count, thread count, and history ID. |
-| `update_drafts` | Updates an existing Gmail draft with new message content and metadata. |
-| `trash_messsages` | Moves a message to the trash folder (acts like delete functionality). |
-| `untrash_messages` | Moves a message out of the trash, effectively undoing a trash action and restoring the message to the user's mailbox. |
-| `get_attachments` | Retrieves the actual file content of a specific attachment from a Gmail message |
-| `update_labels` | Update an existing Gmail label's properties such as name, color, or visibility. |
-| `delete_labels` | Delete a Gmail label by its ID. |
-| `get_filters` | Fetch Gmail filter configuration and rules by filter ID |
-| `delete_filters` | Remove Gmail filter and its associated automation rules |
-| `list_filters` | Retrieve all Gmail filters and their automation settings |
-| `create_filters` | Set up new Gmail filter with criteria and automated actions |
+| `send_email` | Composes and immediately sends an email message via the Gmail API. It can function as a reply within an existing conversation if a `thread_id` is provided. This action is distinct from `send_draft`, which sends a previously saved draft message, or `create_draft`, which only saves an email. |
+| `create_draft` | Saves a new email draft in Gmail with a specified recipient, subject, and body. An optional thread ID can create the draft as a reply within an existing conversation, distinguishing it from `send_email`, which sends immediately. |
+| `send_draft` | Sends a pre-existing Gmail draft identified by its unique ID. It posts to the `/drafts/send` endpoint, converting a saved draft into a sent message. This function acts on drafts from `create_draft` and differs from `send_email`, which composes and sends an email in one step. |
+| `get_draft` | Retrieves a specific Gmail draft by its unique ID. This function allows specifying the output format (e.g., full, raw) to control the response detail. Unlike `list_drafts`, it fetches a single, known draft rather than a collection of multiple drafts. |
+| `list_drafts` | Fetches a list of email drafts, allowing filtering by a search query and limiting results. It can optionally include drafts from spam and trash, returning a collection of draft objects. This is distinct from `get_draft`, which retrieves only a single, specific draft by its ID. |
+| `get_message_details` | Retrieves a specific email from Gmail by its ID. It parses the API response to extract and format key details—including sender, subject, body, and attachments—into a structured dictionary. This function provides detailed data for a single message, distinguishing it from `list_messages` which fetches multiple messages. |
+| `list_messages` | Fetches a paginated list of detailed email messages using optional search queries. It concurrently retrieves full content (sender, subject, body) for each message, returning the results and a pagination token. This differs from `get_message_details`, which fetches only a single message. |
+| `list_labels` | Fetches a complete list of all available labels from the user's Gmail account via the API. It retrieves both system-defined (e.g., INBOX) and user-created labels, returning their names and IDs, complementing management functions like `create_label` and `update_label`. |
+| `create_label` | Creates a new Gmail label with a specified name, hardcoding its visibility to ensure it appears in both label and message lists. This function complements `update_label` and `delete_label` by adding new organizational tags to the user's account via the API. |
+| `get_profile` | Retrieves the authenticated user's Gmail profile from the API. The profile includes the user's email address, total message and thread counts, and the mailbox's history ID, offering a high-level summary of the account's state. |
+| `update_draft` | Replaces the entire content of a specific Gmail draft, identified by its ID, with a new message object. This allows complete modification of the recipient, subject, and body, serving as the primary "edit" function for drafts created via `create_draft`. |
+| `trash_message` | Moves a specific Gmail message to the trash folder by its unique ID. This action performs a soft delete and is the direct counterpart to `untrash_message`, which restores a message. It requires both a user ID and the specific message ID to make the API call. |
+| `untrash_message` | Restores a specific Gmail message from the trash to the user's mailbox, identified by its unique ID. It serves as the direct counterpart to `trash_message`, undoing the deletion action and making the message visible again in the user's account via an API call. |
+| `get_attachment` | Fetches the raw, base64-encoded content of a specific email attachment using its unique ID. It requires the parent message and user IDs for a targeted API request, returning the file's size and data for download or processing, unlike functions that only list attachment metadata. |
+| `update_label` | Updates an existing Gmail label's properties, such as its name, color, or visibility, using its unique ID. This modification function is distinct from `create_label` and `delete_label`, returning the full, updated label resource from the API upon successful completion. |
+| `delete_label` | Permanently removes a specific Gmail label from a user's account, identified by its unique ID. This function performs an irreversible deletion via an API call, requiring both the `userId` and the label `id`. It is the destructive counterpart to `create_label` and `update_label`. |
+| `get_filter` | Fetches a single Gmail filter's configuration by its unique ID for a specified user. It returns the filter’s criteria (e.g., sender) and actions (e.g., add label). This differs from `get_all_filters`, which retrieves a complete list of all filters for the user. |
+| `delete_filter` | Permanently removes a specific Gmail filter, identified by its unique ID, from a user's account. This action deletes the filter's criteria and all associated automation rules, making it the destructive counterpart to `create_filter` and `get_filter`. |
+| `get_all_filters` | Retrieves all configured email filters for a specified Gmail user ID. It fetches a list of a user's filters, including their matching criteria and automated actions, distinguishing it from `get_filter`, which retrieves only a single filter. |
+| `create_filter` | Creates a new automated email filter in Gmail for a specified user. It requires defining matching criteria (e.g., sender, subject) and an action (e.g., add label). This function adds new rules, distinguishing it from `get_all_filters` and `delete_filter` which manage existing ones. |