universal-mcp-applications 0.1.17__tar.gz → 0.1.19__tar.gz

universal_mcp_applications-0.1.19/.gitignore

@@ -0,0 +1,60 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Environment variables
+.env
+.env.local
+
+
+dump/
+
+
+# SQLite database
+*.db
+*.sqlite
+*.sqlite3
+*.db-shm
+*.db-wal
+
+
+# Pyright
+.pyright
+
+# Ruff
+.ruff_cache
+
+# Pytest
+.pytest_cache
+
+
+# Local config
+local_config.json
+
+
+# Test Artifacts
+test_artifacts/
+src/universal_mcp/applications/complex/
+src/universal_mcp/applications/test/
+src/universal_mcp/applications/test_with_docs/
+src/universal_mcp/applications/test_without_docs/
+
+# Temporary files
+tmp/
+
+
+# Docs
+site/
+.cache/
+
+# langgraph temporary files
+.langgraph_api/
+langgraph.json
+agentr-1-6c4ebd5cc914.json

{universal_mcp_applications-0.1.17 → universal_mcp_applications-0.1.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: universal-mcp-applications
-Version: 0.1.17
+Version: 0.1.19
 Summary: A Universal MCP Application: universal_mcp_applications
 Project-URL: Homepage, https://github.com/universal-mcp/applications
 Project-URL: Repository, https://github.com/universal-mcp/applications
@@ -85,91 +85,4 @@ result = app.some_method(param1="value1")
 
 # Process and print the output
 process_output(result)
-```
-
-## Included Applications
-
-This package includes the following 82 applications:
-
-- `ahrefs`
-- `airtable`
-- `apollo`
-- `asana`
-- `aws-s3`
-- `bill`
-- `box`
-- `braze`
-- `cal-com-v2`
-- `calendly`
-- `canva`
-- `clickup`
-- `coda`
-- `confluence`
-- `contentful`
-- `crustdata`
-- `dialpad`
-- `digitalocean`
-- `domain-checker`
-- `e2b`
-- `elevenlabs`
-- `exa`
-- `falai`
-- `figma`
-- `firecrawl`
-- `fireflies`
-- `fpl`
-- `ghost-content`
-- `github`
-- `gong`
-- `google-ads`
-- `google-calendar`
-- `google-docs`
-- `google-drive`
-- `google-gemini`
-- `google-mail`
-- `google-searchconsole`
-- `google-sheet`
-- `hashnode`
-- `heygen`
-- `http-tools`
-- `hubspot`
-- `jira`
-- `klaviyo`
-- `linkedin`
-- `mailchimp`
-- `markitdown`
-- `miro`
-- `ms-teams`
-- `neon`
-- `notion`
-- `openai`
-- `outlook`
-- `perplexity`
-- `pipedrive`
-- `posthog`
-- `reddit`
-- `replicate`
-- `resend`
-- `retell`
-- `rocketlane`
-- `semanticscholar`
-- `semrush`
-- `sendgrid`
-- `sentry`
-- `serpapi`
-- `sharepoint`
-- `shopify`
-- `shortcut`
-- `slack`
-- `spotify`
-- `supabase`
-- `tavily`
-- `trello`
-- `twillo`
-- `twitter`
-- `unipile`
-- `whatsapp`
-- `whatsapp-business`
-- `wrike`
-- `youtube`
-- `zenquotes`
+```

{universal_mcp_applications-0.1.17 → universal_mcp_applications-0.1.19}/README.md

@@ -39,91 +39,4 @@ result = app.some_method(param1="value1")
 
 # Process and print the output
 process_output(result)
-```
-
-## Included Applications
-
-This package includes the following 82 applications:
-
-- `ahrefs`
-- `airtable`
-- `apollo`
-- `asana`
-- `aws-s3`
-- `bill`
-- `box`
-- `braze`
-- `cal-com-v2`
-- `calendly`
-- `canva`
-- `clickup`
-- `coda`
-- `confluence`
-- `contentful`
-- `crustdata`
-- `dialpad`
-- `digitalocean`
-- `domain-checker`
-- `e2b`
-- `elevenlabs`
-- `exa`
-- `falai`
-- `figma`
-- `firecrawl`
-- `fireflies`
-- `fpl`
-- `ghost-content`
-- `github`
-- `gong`
-- `google-ads`
-- `google-calendar`
-- `google-docs`
-- `google-drive`
-- `google-gemini`
-- `google-mail`
-- `google-searchconsole`
-- `google-sheet`
-- `hashnode`
-- `heygen`
-- `http-tools`
-- `hubspot`
-- `jira`
-- `klaviyo`
-- `linkedin`
-- `mailchimp`
-- `markitdown`
-- `miro`
-- `ms-teams`
-- `neon`
-- `notion`
-- `openai`
-- `outlook`
-- `perplexity`
-- `pipedrive`
-- `posthog`
-- `reddit`
-- `replicate`
-- `resend`
-- `retell`
-- `rocketlane`
-- `semanticscholar`
-- `semrush`
-- `sendgrid`
-- `sentry`
-- `serpapi`
-- `sharepoint`
-- `shopify`
-- `shortcut`
-- `slack`
-- `spotify`
-- `supabase`
-- `tavily`
-- `trello`
-- `twillo`
-- `twitter`
-- `unipile`
-- `whatsapp`
-- `whatsapp-business`
-- `wrike`
-- `youtube`
-- `zenquotes`
+```

{universal_mcp_applications-0.1.17 → universal_mcp_applications-0.1.19}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "universal-mcp-applications"
-version = "0.1.17"
+version = "0.1.19"
 description = "A Universal MCP Application: universal_mcp_applications"
 readme = "README.md"
 requires-python = ">=3.11"

{universal_mcp_applications-0.1.17 → universal_mcp_applications-0.1.19}/src/scripts/docgen.py

@@ -30,7 +30,7 @@ class DescriptionOutput(BaseModel):
     """Structure for the generated description output."""
 
     description: str = Field(description="A clear, detailed description of what the function does")
-    suggested_name: Optional[str] = Field(None, description="A better name for the function, if applicable")
+    # suggested_name: Optional[str] = Field(None, description="A better name for the function, if applicable")
 
 
 class FunctionExtractor(ast.NodeVisitor):
@@ -244,7 +244,7 @@ def generate_description(
                 parsed_data = extract_json_from_text(response_text)
                 return DescriptionOutput(
                     description=parsed_data.get("description", "No description available."),
-                    suggested_name=parsed_data.get("suggested_name"),
+                    # suggested_name=parsed_data.get("suggested_name"),
                 )
             except ValueError as e:
                 print(f"  - JSON extraction failed: {e}")
@@ -442,7 +442,7 @@ def process_file(file_path: str, model: str = "perplexity/sonar") -> int:
         # 1. Generate new description and check for suggested name
         output = generate_description(function_code, original_content, model)
         new_description = output.description.strip()
-        suggested_name = output.suggested_name
+        # suggested_name = output.suggested_name
 
         if not new_description or "Error generating description" in new_description:
             print(f"  - Failed to generate description for '{function_name}', skipping.")
@@ -456,10 +456,10 @@ def process_file(file_path: str, model: str = "perplexity/sonar") -> int:
         # 3. Handle function renaming if suggested
         code_to_update = function_code
         is_renamed = False
-        if suggested_name and suggested_name != function_name:
-            print(f"  - Renaming function '{function_name}' to '{suggested_name}'")
-            code_to_update = rename_function_in_code(code_to_update, function_name, suggested_name)
-            is_renamed = True
+        # if suggested_name and suggested_name != function_name:
+        #     print(f"  - Renaming function '{function_name}' to '{suggested_name}'")
+        #     code_to_update = rename_function_in_code(code_to_update, function_name, suggested_name)
+        #     is_renamed = True
 
         # 4. Insert the new docstring back into the (potentially renamed) function code
         updated_function_block = insert_docstring_into_function(code_to_update, reconstructed_docstring)
@@ -468,11 +468,11 @@ def process_file(file_path: str, model: str = "perplexity/sonar") -> int:
         if updated_function_block != function_code:
             updated_content = updated_content.replace(function_code, updated_function_block)
             count += 1
-            print(f"  - Updated function block for '{suggested_name or function_name}'.")
+            print(f"  - Updated function block for '{function_name}'.")
             
             # 6. If the function was renamed, also update the list_tools method
-            if is_renamed:
-                updated_content = update_list_tools_method(updated_content, function_name, suggested_name)
+            # if is_renamed:
+            #     updated_content = update_list_tools_method(updated_content, function_name, suggested_name)
 
     if updated_content != original_content:
         with open(file_path, "w", encoding="utf-8") as f:

{universal_mcp_applications-0.1.17 → universal_mcp_applications-0.1.19}/src/scripts/prompts.py

@@ -6,7 +6,6 @@ You will be given the full context of a Python script, followed by a request to
 
 Your tasks are:
 1.  **Write a High-Quality Description:** The description should be comprehensive, clear, and accurately reflect the function's purpose.
-2.  **Suggest a Better Name (If Necessary):** Analyze the function's original name. If you believe a different name would be more descriptive or intuitive based on what the function does, suggest a new one. If the current name is good, you can omit this suggestion.
 3.  **Differentiate Similar Functions:** Use the full script context to clarify the unique role of this function, especially if other functions have similar names or functionality.
 
 The full script content is:
@@ -15,14 +14,13 @@ The full script content is:
 --- SCRIPT END ---
 """
 
-USER_PROMPT_TEMPLATE = """Based on the full script provided, analyze the following Python function. Generate a high-quality description and, if you think it's necessary, suggest a better name for it.
+USER_PROMPT_TEMPLATE = """Based on the full script provided, analyze the following Python function. Generate a high-quality description.
 
 Function to analyze:
 ```python
 {function_code}
-Respond ONLY in the following JSON format. If you do not want to suggest a new name, you can omit the "suggested_name" key.
+Respond ONLY in the following JSON format.
 {{
 "description": "A clear and detailed description of what the function does, taking into account the full script context.",
-"suggested_name": "A more descriptive and clear name for the function (optional)"
 }}
 """

universal_mcp_applications-0.1.19/src/scripts/readme.py

@@ -0,0 +1,115 @@
+import os
+import subprocess
+
+APPS = [
+    "ahrefs",
+    "airtable",
+    "apollo",
+    "asana",
+    "aws_s3",
+    "bill",
+    "box",
+    "braze",
+    "cal_com_v2",
+    "calendly",
+    "canva",
+    "clickup",
+    "coda",
+    "confluence",
+    "contentful",
+    "crustdata",
+    "dialpad",
+    "digitalocean",
+    "domain_checker",
+    "e2b",
+    "elevenlabs",
+    "exa",
+    "falai",
+    "figma",
+    "file_system",
+    "firecrawl",
+    "fireflies",
+    "fpl",
+    "ghost_content",
+    "github",
+    "gong",
+    "google_calendar",
+    "google_docs",
+    "google_drive",
+    "google_gemini",
+    "google_mail",
+    "google_searchconsole",
+    "google_sheet",
+    "hashnode",
+    "heygen",
+    "http_tools",
+    "hubspot",
+    "jira",
+    "klaviyo",
+    "linkedin",
+    "mailchimp",
+    "markitdown",
+    "miro",
+    "ms_teams",
+    "neon",
+    "notion",
+    "openai",
+    "outlook",
+    "perplexity",
+    "pipedrive",
+    "posthog",
+    "reddit",
+    "replicate",
+    "resend",
+    "retell",
+    "rocketlane",
+    "scraper",
+    "semanticscholar",
+    "semrush",
+    "sendgrid",
+    "sentry",
+    "serpapi",
+    "sharepoint",
+    "shopify",
+    "shortcut",
+    "slack",
+    "spotify",
+    "supabase",
+    "tavily",
+    "trello",
+    "twilio",
+    "twitter",
+    "unipile",
+    "whatsapp",
+    "whatsapp_business",
+    "wrike",
+    "youtube",
+    "zenquotes",
+]
+
+def main():
+    """
+    Runs the readme generation for a predefined list of applications.
+    """
+    base_path = os.path.abspath(os.path.join(os.path.dirname(__file__), '..', 'universal_mcp', 'applications'))
+    
+    for app in APPS:
+        app_path = os.path.join(base_path, app, "app.py")
+        command = ["universal_mcp", "codegen", "readme", app_path]
+        
+        print(f"Running readme codegen for: {app}")
+        try:
+            # Using 'uv run' to ensure the command is executed in the correct environment
+            result = subprocess.run(["uv", "run"] + command, check=True, capture_output=True, text=True)
+            print(f"Successfully generated readme for: {app}")
+            # print(result.stdout) # Optional: print stdout for more details
+        except subprocess.CalledProcessError as e:
+            print(f"Error generating readme for {app}: {e}")
+            print(f"Stderr: {e.stderr}")
+            print(f"Stdout: {e.stdout}")
+        except FileNotFoundError:
+            print(f"Error: Could not find app file for {app} at {app_path}")
+        print("-" * 20)
+
+if __name__ == "__main__":
+    main()

{universal_mcp_applications-0.1.17 → universal_mcp_applications-0.1.19}/src/scripts/run_docgen.py

@@ -3,41 +3,15 @@ import os
 import subprocess
 
 APPS = [
-    "aws_s3",
-    "calendly",
-    "canva",
-    "domain_checker",
-    "e2b",
-    "elevenlabs",
-    "exa",
-    "falai",
-    "file_system",
-    "firecrawl",
-    "fireflies",
-    "fpl",
+    "google_mail",
     "google_calendar",
     "google_docs",
     "google_drive",
     "google_searchconsole",
     "google_sheet",
-    "http_tools",
     "linkedin",
     "ms_teams",
-    "openai",
     "outlook",
-    "replicate",
-    "resend",
-    "scraper",
-    "serpapi",
-    "sharepoint",
-    "slack",
-    "tavily",
-    "twitter",
-    "unipile",
-    "whatsapp",
-    "whatsapp_business",
-    "youtube",
-    "zenquotes",
 ]
 
 def main():

{universal_mcp_applications-0.1.17 → universal_mcp_applications-0.1.19}/src/universal_mcp/applications/ahrefs/README.md

@@ -1,10 +1,10 @@
-# Ahrefs MCP Server
+# AhrefsApp MCP Server
 
-An MCP Server for the Ahrefs API.
+An MCP Server for the AhrefsApp API.
 
 ## 🛠️ Tool List
 
-This is automatically generated from OpenAPI schema for the Ahrefs API.
+This is automatically generated from OpenAPI schema for the AhrefsApp API.
 
 
 | Tool | Description |

{universal_mcp_applications-0.1.17 → universal_mcp_applications-0.1.19}/src/universal_mcp/applications/airtable/README.md

@@ -1,10 +1,10 @@
-# Airtable MCP Server
+# AirtableApp MCP Server
 
-An MCP Server for the Airtable API.
+An MCP Server for the AirtableApp API.
 
 ## 🛠️ Tool List
 
-This is automatically generated from OpenAPI schema for the Airtable API.
+This is automatically generated from OpenAPI schema for the AirtableApp API.
 
 
 | Tool | Description |

{universal_mcp_applications-0.1.17 → universal_mcp_applications-0.1.19}/src/universal_mcp/applications/asana/README.md

@@ -1,10 +1,10 @@
-# Asana MCP Server
+# AsanaApp MCP Server
 
-An MCP Server for the Asana API.
+An MCP Server for the AsanaApp API.
 
 ## 🛠️ Tool List
 
-This is automatically generated from OpenAPI schema for the Asana API.
+This is automatically generated from OpenAPI schema for the AsanaApp API.
 
 
 | Tool | Description |

universal_mcp_applications-0.1.19/src/universal_mcp/applications/aws_s3/README.md

@@ -0,0 +1,29 @@
+# AwsS3App MCP Server
+
+An MCP Server for the AwsS3App API.
+
+## 🛠️ Tool List
+
+This is automatically generated from OpenAPI schema for the AwsS3App API.
+
+
+| Tool | Description |
+|------|-------------|
+| `create_bucket` | Creates a new Amazon S3 bucket with a specified name and optional region. Returns `True` upon successful creation, or `False` if an AWS client error, such as a naming conflict or permission issue, occurs. |
+| `delete_bucket` | Deletes a specified S3 bucket. The operation requires the bucket to be empty to succeed. It returns `True` if the bucket is successfully deleted and `False` if an error occurs, such as the bucket not being found or containing objects. |
+| `get_bucket_policy` | Retrieves the IAM resource policy for a specified S3 bucket, parsing the JSON string into a dictionary. If the operation fails due to permissions or a non-existent policy, it returns an error dictionary. This complements `put_bucket_policy`, which applies a new policy. |
+| `set_bucket_policy` | Applies or replaces the access policy for a specified S3 bucket. The function accepts the policy as a dictionary, converts it to JSON, and assigns it to the bucket. This write operation is the counterpart to `get_bucket_policy` and returns `True` on success. |
+| `list_subdirectories` | Lists immediate subdirectories (common prefixes) within an S3 bucket. If a prefix is provided, it returns subdirectories under that path; otherwise, it lists top-level directories. This function specifically lists folders, distinguishing it from `list_objects`, which lists files. |
+| `create_prefix` | Creates a prefix (folder) in an S3 bucket, optionally nested under a parent prefix. It simulates a directory by creating a zero-byte object with a key ending in a slash ('/'), distinguishing it from put_object, which uploads content. |
+| `list_objects` | Paginates through and lists all objects within a specified S3 bucket prefix. It returns a curated list of metadata for each object (key, name, size, last modified), excluding folder placeholders. This function specifically lists files, distinguishing it from `list_prefixes` which lists folders. |
+| `put_text_object` | Uploads string content to create an object in a specified S3 bucket and prefix. The content is UTF-8 encoded before being written. This method is for text, distinguishing it from `put_object_from_base64` which handles binary data. |
+| `put_object_from_base64` | Decodes a base64 string into binary data and uploads it as an object to a specified S3 location. This method is designed for binary files, differentiating it from `put_object` which handles plain text content. Returns true on success. |
+| `get_object_with_content` | Retrieves an S3 object's content. It decodes text files as UTF-8 or encodes binary files as base64 based on the object's key. This function downloads the full object body, unlike `get_object_metadata` which only fetches metadata without content, returning the content, name, size, and type. |
+| `get_object_metadata` | Efficiently retrieves metadata for a specified S3 object, such as size and last modified date, without downloading its content. This function uses a HEAD request, making it faster than `get_object_content` for accessing object properties. Returns a dictionary of metadata or an error message on failure. |
+| `copy_object` | Copies an S3 object from a specified source location to a destination, which can be in the same or a different bucket. Unlike `move_object`, the original object remains at the source after the copy operation. It returns `True` for a successful operation. |
+| `move_object` | Moves an S3 object from a source to a destination. This is achieved by first copying the object to the new location and subsequently deleting the original. The move can occur within the same bucket or between different ones, returning `True` on success. |
+| `delete_single_object` | Deletes a single, specified object from an S3 bucket using its key. Returns `True` if successful, otherwise `False`. For bulk deletions in a single request, the `delete_objects` function should be used instead. |
+| `delete_objects` | Performs a bulk deletion of objects from a specified S3 bucket in a single request. Given a list of keys, it returns a dictionary detailing successful deletions and any errors. This method is the batch-processing counterpart to the singular `delete_object` function, designed for efficiency. |
+| `generate_presigned_url` | Generates a temporary, secure URL for a specific S3 object. This URL grants time-limited permissions for actions like GET, PUT, or DELETE, expiring after a defined period. It allows object access without sharing permanent AWS credentials. |
+| `search_objects` | Filters objects within an S3 bucket and prefix based on a name pattern and size range. It retrieves all objects via `list_objects` and then applies the specified criteria client-side, returning a refined list of matching objects and their metadata. |
+| `get_storage_summary` | Calculates and returns statistics for an S3 bucket or prefix. The result includes the total number of objects, their combined size in bytes, and a human-readable string representation of the size (e.g., '15.2 MB'). |