universal-mcp-applications 0.1.21__tar.gz → 0.1.22__tar.gz

{universal_mcp_applications-0.1.21 → universal_mcp_applications-0.1.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: universal-mcp-applications
-Version: 0.1.21
+Version: 0.1.22
 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
@@ -13,6 +13,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Requires-Python: >=3.11
 Requires-Dist: boto3>=1.38.32
+Requires-Dist: browser-use-sdk>=2.0.4
 Requires-Dist: dnspython>=2.4.0
 Requires-Dist: e2b-code-interpreter>=1.2.1
 Requires-Dist: elevenlabs>=2.14.0

{universal_mcp_applications-0.1.21 → universal_mcp_applications-0.1.22}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "universal-mcp-applications"
-version = "0.1.21"
+version = "0.1.22"
 description = "A Universal MCP Application: universal_mcp_applications"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -21,6 +21,7 @@ classifiers = [
 ]
 dependencies = [
     "boto3>=1.38.32",
+    "browser-use-sdk>=2.0.4",
     "dnspython>=2.4.0",
     "e2b-code-interpreter>=1.2.1",
     "elevenlabs>=2.14.0",
@@ -45,7 +46,6 @@ dependencies = [
     "universal-mcp>=0.1.24rc21",
     "yfinance>=0.2.66",
     "youtube-transcript-api==1.2.2",
-    
 ]
 
 [project.license]
@@ -77,7 +77,6 @@ test-cov = "pytest --cov-report term-missing --cov-config=pyproject.toml --cov=s
 lint = "ruff check . && ruff format --check ."
 format = "ruff format ."
 
-
 [tool.hatch.build.targets.wheel]
 packages = [
     "src/universal_mcp",
@@ -85,7 +84,7 @@ packages = [
 
 [tool.coverage.run]
 source = [
-    "src",   
+    "src",
 ]
 branch = true
 
@@ -94,12 +93,11 @@ show_missing = true
 fail_under = 70
 
 [tool.ruff]
-line-length = 88
-select = [
+line-length = 140
+lint.select = [
     "E", "W", "F", "I", "UP", "PL", "T20",
 ]
-ignore = []
-
+lint.ignore = []
 
 [tool.ruff.format]
 quote-style = "double"
@@ -114,4 +112,3 @@ dev = [
     "litellm>=1.77.3",
     "universal-mcp-agents>=0.1.13",
 ]
-

{universal_mcp_applications-0.1.21 → universal_mcp_applications-0.1.22}/src/scripts/docgen.py

@@ -7,12 +7,11 @@ names for Python functions using LLMs with structured output.
 import ast
 import json
 import os
-from pathlib import Path
 import re
 import sys
 import time
 import traceback
-from typing import Optional
+from pathlib import Path
 
 import typer
 from rich.console import Console
@@ -29,7 +28,9 @@ from src.scripts.prompts import SYSTEM_PROMPT_TEMPLATE, USER_PROMPT_TEMPLATE
 class DescriptionOutput(BaseModel):
     """Structure for the generated description output."""
 
-    description: str = Field(description="A clear, detailed description of what the function does")
+    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")
 
 
@@ -41,17 +42,16 @@ class FunctionExtractor(ast.NodeVisitor):
 
     def __init__(self, source_code: str):
         self.source_lines = source_code.splitlines(keepends=True)
-        self.functions: list[tuple[str, str]] = []  # Store tuples of (function_name, function_source)
+        self.functions: list[
+            tuple[str, str]
+        ] = []  # Store tuples of (function_name, function_source)
 
     def _get_source_segment(self, node: ast.AST) -> str | None:
         """Safely extracts the source segment for a node using ast.get_source_segment."""
         try:
             source_segment = ast.get_source_segment("".join(self.source_lines), node)
             return source_segment
-        except Exception as e:
-            print(
-                f"Warning: Could not retrieve source for node {getattr(node, 'name', 'unknown')} at line {getattr(node, 'lineno', 'unknown')}: {e}"
-            )
+        except Exception:
             return None
 
     def visit_FunctionDef(self, node: ast.FunctionDef):
@@ -92,19 +92,15 @@ def extract_functions_from_script(file_path: str) -> list[tuple[str, str]]:
         with open(file_path, encoding="utf-8") as f:
             source_code = f.read()
     except FileNotFoundError:
-        print(f"Error: File not found at {file_path}")
         raise
-    except Exception as e:
-        print(f"Error reading file {file_path}: {e}")
+    except Exception:
         raise
 
     try:
         tree = ast.parse(source_code, filename=file_path)
-    except SyntaxError as e:
-        print(f"Error: Invalid Python syntax in {file_path} at line {e.lineno}, offset {e.offset}: {e.msg}")
+    except SyntaxError:
         raise
-    except Exception as e:
-        print(f"Error parsing {file_path} into AST: {e}")
+    except Exception:
         raise
 
     try:
@@ -112,11 +108,10 @@ def extract_functions_from_script(file_path: str) -> list[tuple[str, str]]:
         extractor.visit(tree)
 
         if not extractor.functions:
-            print("Warning: No functions found in the file.")
+            pass
 
         return extractor.functions
-    except Exception as e:
-        print(f"Error during function extraction: {e}")
+    except Exception:
         import traceback
 
         traceback.print_exc()
@@ -176,7 +171,7 @@ def parse_existing_docstring(docstring: str | None) -> tuple[str, str]:
     if not docstring:
         return "", ""
 
-    lines = docstring.strip().split('\n')
+    lines = docstring.strip().split("\n")
     summary_lines = []
     rest_lines = []
     summary_done = False
@@ -186,15 +181,19 @@ def parse_existing_docstring(docstring: str | None) -> tuple[str, str]:
 
     for i, line in enumerate(lines):
         stripped_line = line.strip()
-        if not summary_done and stripped_line and not stripped_line.startswith(section_markers):
+        if (
+            not summary_done
+            and stripped_line
+            and not stripped_line.startswith(section_markers)
+        ):
             summary_lines.append(line.strip())
         elif not summary_done and not stripped_line and summary_lines:
             # This blank line marks the end of the summary
             summary_done = True
-            rest_lines = lines[i+1:]
+            rest_lines = lines[i + 1 :]
             break
         elif stripped_line.startswith(section_markers):
-             # A section starts immediately after the summary
+            # A section starts immediately after the summary
             summary_done = True
             rest_lines = lines[i:]
             break
@@ -243,30 +242,30 @@ def generate_description(
             try:
                 parsed_data = extract_json_from_text(response_text)
                 return DescriptionOutput(
-                    description=parsed_data.get("description", "No description available."),
+                    description=parsed_data.get(
+                        "description", "No description available."
+                    ),
                     # suggested_name=parsed_data.get("suggested_name"),
                 )
-            except ValueError as e:
-                print(f"  - JSON extraction failed: {e}")
+            except ValueError:
                 return DescriptionOutput(description="Failed to extract description.")
 
         except litellm.InternalServerError as e:
             if attempt < max_retries - 1:
                 delay = base_delay * (2**attempt)
-                print(
-                    f"  - Server error occurred: {e}. Retrying in {delay} seconds... (Attempt {attempt + 1}/{max_retries})",
-                    file=sys.stderr,
-                )
                 time.sleep(delay)
             else:
-                print(f"  - Max retries reached. Error generating description: {e}", file=sys.stderr)
-                return DescriptionOutput(description=f"Error generating description after {max_retries} retries: {e}")
+                return DescriptionOutput(
+                    description=f"Error generating description after {max_retries} retries: {e}"
+                )
 
         except Exception as e:
-            print(f"  - An unexpected error occurred: {e}", file=sys.stderr)
             return DescriptionOutput(description=f"An unexpected error occurred: {e}")
 
-    return DescriptionOutput(description="Failed to generate description after all retries.")
+    return DescriptionOutput(
+        description="Failed to generate description after all retries."
+    )
+
 
 def insert_docstring_into_function(function_code: str, docstring: str) -> str:
     """
@@ -282,7 +281,9 @@ def insert_docstring_into_function(function_code: str, docstring: str) -> str:
     try:
         lines = function_code.splitlines(keepends=True)
         tree = ast.parse(function_code)
-        if not tree.body or not isinstance(tree.body[0], (ast.FunctionDef, ast.AsyncFunctionDef)):
+        if not tree.body or not isinstance(
+            tree.body[0], (ast.FunctionDef, ast.AsyncFunctionDef)
+        ):
             return function_code
 
         func_node = tree.body[0]
@@ -292,7 +293,9 @@ def insert_docstring_into_function(function_code: str, docstring: str) -> str:
         if func_node.body:
             # Use the indentation of the first statement in the body (e.g., the old docstring).
             first_body_line_str = lines[func_node.body[0].lineno - 1]
-            body_indent = first_body_line_str[: len(first_body_line_str) - len(first_body_line_str.lstrip())]
+            body_indent = first_body_line_str[
+                : len(first_body_line_str) - len(first_body_line_str.lstrip())
+            ]
         else:
             # Fallback for empty functions: calculate from the 'def' line.
             def_line = lines[func_node.lineno - 1]
@@ -302,36 +305,41 @@ def insert_docstring_into_function(function_code: str, docstring: str) -> str:
 
         # Format the new docstring with the determined indentation
         new_docstring_lines_formatted = [f'{body_indent}"""\n']
-        new_docstring_lines_formatted.extend([f"{body_indent}{line}\n" for line in docstring.splitlines()])
+        new_docstring_lines_formatted.extend(
+            [f"{body_indent}{line}\n" for line in docstring.splitlines()]
+        )
         new_docstring_lines_formatted.append(f'{body_indent}"""\n')
 
         # Check if the first statement is an existing docstring
         existing_docstring_node = None
         if (
-            func_node.body and
-            isinstance(func_node.body[0], ast.Expr) and
-            isinstance(func_node.body[0].value, ast.Constant) and
-            isinstance(func_node.body[0].value.value, str)
+            func_node.body
+            and isinstance(func_node.body[0], ast.Expr)
+            and isinstance(func_node.body[0].value, ast.Constant)
+            and isinstance(func_node.body[0].value.value, str)
         ):
             existing_docstring_node = func_node.body[0]
 
         # Splice the code
-        insert_idx = func_node.body[0].lineno - 1 if func_node.body else func_node.lineno
+        insert_idx = (
+            func_node.body[0].lineno - 1 if func_node.body else func_node.lineno
+        )
         pre_insertion_lines = lines[:insert_idx]
 
         if existing_docstring_node:
-            post_insertion_lines = lines[existing_docstring_node.end_lineno:]
+            post_insertion_lines = lines[existing_docstring_node.end_lineno :]
         else:
             post_insertion_lines = lines[insert_idx:]
 
-        output_lines = pre_insertion_lines + new_docstring_lines_formatted + post_insertion_lines
+        output_lines = (
+            pre_insertion_lines + new_docstring_lines_formatted + post_insertion_lines
+        )
 
         final_code = "".join(output_lines)
-        ast.parse(final_code) # Validate syntax
+        ast.parse(final_code)  # Validate syntax
         return final_code
 
-    except Exception as e:
-        print(f"Error processing function snippet for insertion: {e}", file=sys.stderr)
+    except Exception:
         traceback.print_exc(file=sys.stderr)
         return function_code
 
@@ -351,13 +359,14 @@ def rename_function_in_code(function_code: str, old_name: str, new_name: str) ->
     # This regex looks for 'def' or 'async def' followed by the old name
     pattern = r"(async\s+def|def)\s+" + re.escape(old_name) + r"(\s*\()"
     replacement = r"\1 " + new_name + r"\2"
-    
-    new_function_code, num_replacements = re.subn(pattern, replacement, function_code, 1)
+
+    new_function_code, num_replacements = re.subn(
+        pattern, replacement, function_code, 1
+    )
 
     if num_replacements == 0:
-        print(f"  - Warning: Could not rename function '{old_name}'. Name not found in definition.")
         return function_code
-    
+
     return new_function_code
 
 
@@ -383,22 +392,23 @@ def update_list_tools_method(content: str, old_name: str, new_name: str) -> str:
     replacement = r"\1" + new_name
 
     # First, find the list_tools method definition to narrow the search area
-    list_tools_match = re.search(r"def\s+list_tools\s*\([^)]*\):\s*return\s*\[[^\]]*\]", content, re.DOTALL)
-    
+    list_tools_match = re.search(
+        r"def\s+list_tools\s*\([^)]*\):\s*return\s*\[[^\]]*\]", content, re.DOTALL
+    )
+
     if not list_tools_match:
-        print("  - Warning: `list_tools` method not found or has an unexpected format. Cannot update tool list.")
         return content
 
     list_tools_code = list_tools_match.group(0)
-    
+
     # Perform the replacement only within the found method block
-    updated_list_tools_code, num_replacements = re.subn(pattern, replacement, list_tools_code)
+    updated_list_tools_code, num_replacements = re.subn(
+        pattern, replacement, list_tools_code
+    )
 
     if num_replacements > 0:
-        print(f"  - Renamed '{old_name}' to '{new_name}' in `list_tools` method.")
         return content.replace(list_tools_code, updated_list_tools_code)
     else:
-        print(f"  - Warning: Function '{old_name}' not found in `list_tools` method.")
         return content
 
 
@@ -421,14 +431,12 @@ def process_file(file_path: str, model: str = "perplexity/sonar") -> int:
 
     functions = extract_functions_from_script(file_path)
     if not functions:
-        print(f"No functions found in {file_path}")
         return 0
 
     updated_content = original_content
     count = 0
 
     for function_name, function_code in functions:
-        print(f"Processing function: {function_name}")
 
         try:
             func_tree = ast.parse(function_code)
@@ -436,7 +444,6 @@ def process_file(file_path: str, model: str = "perplexity/sonar") -> int:
             existing_docstring = ast.get_docstring(func_node, clean=True)
             _, rest_of_docstring = parse_existing_docstring(existing_docstring)
         except (SyntaxError, IndexError):
-            print(f"  - Could not parse function '{function_name}', skipping.")
             continue
 
         # 1. Generate new description and check for suggested name
@@ -445,31 +452,32 @@ def process_file(file_path: str, model: str = "perplexity/sonar") -> int:
         # 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.")
             continue
 
         # 2. Reconstruct the full docstring content
         reconstructed_docstring = new_description
         if rest_of_docstring:
             reconstructed_docstring += "\n\n" + rest_of_docstring
-        
+
         # 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
 
         # 4. Insert the new docstring back into the (potentially renamed) function code
-        updated_function_block = insert_docstring_into_function(code_to_update, reconstructed_docstring)
+        updated_function_block = insert_docstring_into_function(
+            code_to_update, reconstructed_docstring
+        )
 
         # 5. If any changes were made, update the main content
         if updated_function_block != function_code:
-            updated_content = updated_content.replace(function_code, updated_function_block)
+            updated_content = updated_content.replace(
+                function_code, updated_function_block
+            )
             count += 1
-            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)
@@ -477,14 +485,15 @@ def process_file(file_path: str, model: str = "perplexity/sonar") -> int:
     if updated_content != original_content:
         with open(file_path, "w", encoding="utf-8") as f:
             f.write(updated_content)
-        print(f"\nUpdated {count} functions in {file_path}")
     else:
-        print("\nNo changes made to the file.")
+        pass
 
     return count
 
 
 app = typer.Typer()
+
+
 @app.command()
 def docgen(
     file_path: Path = typer.Argument(..., help="Path to the Python file to process"),
@@ -512,5 +521,6 @@ def docgen(
         console.print(f"[red]Error: {e}[/red]")
         raise typer.Exit(1) from e
 
+
 if __name__ == "__main__":
-    app()
+    app()

{universal_mcp_applications-0.1.21 → universal_mcp_applications-0.1.22}/src/scripts/prompts.py

@@ -23,4 +23,4 @@ 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.",
 }}
-"""
+"""

{universal_mcp_applications-0.1.21 → universal_mcp_applications-0.1.22}/src/scripts/readme.py

@@ -87,29 +87,30 @@ APPS = [
     "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'))
-    
+    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}")
+            subprocess.run(
+                ["uv", "run"] + command, check=True, capture_output=True, text=True
+            )
             # 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 subprocess.CalledProcessError:
+            pass
         except FileNotFoundError:
-            print(f"Error: Could not find app file for {app} at {app_path}")
-        print("-" * 20)
+            pass
+
 
 if __name__ == "__main__":
     main()

{universal_mcp_applications-0.1.21 → universal_mcp_applications-0.1.22}/src/scripts/run_docgen.py

@@ -1,4 +1,3 @@
-
 import os
 import subprocess
 
@@ -14,26 +13,25 @@ APPS = [
     "outlook",
 ]
 
+
 def main():
     """
     Runs the docgen.py script for a predefined list of applications.
     """
     script_path = "src/scripts/docgen.py"
     base_path = "/Users/ankitranjan/Work/applications/src/universal_mcp/applications"
-    
+
     for app in APPS:
         app_path = os.path.join(base_path, app, "app.py")
         command = ["python", script_path, app_path]
-        
-        print(f"Running docgen for: {app}")
+
         try:
             subprocess.run(command, check=True)
-            print(f"Successfully generated docs for: {app}")
-        except subprocess.CalledProcessError as e:
-            print(f"Error generating docs for {app}: {e}")
+        except subprocess.CalledProcessError:
+            pass
         except FileNotFoundError:
-            print(f"Error: Could not find app file for {app} at {app_path}")
-        print("-" * 20)
+            pass
+
 
 if __name__ == "__main__":
     main()

{universal_mcp_applications-0.1.21 → universal_mcp_applications-0.1.22}/src/tests/test_applications.py

@@ -1,5 +1,4 @@
 import pytest
-
 from universal_mcp.applications.utils import app_from_slug
 from universal_mcp.utils.testing import check_application_instance
 
@@ -9,18 +8,18 @@ ALL_APPS = [
     "apollo",
     "asana",
     "aws_s3",
-    "bill",     # not seeded
+    "bill",  # not seeded
     "box",
     "braze",
-    #"cal_com_v2",   # not seeded
+    # "cal_com_v2",   # not seeded
     "calendly",
     "canva",
     "clickup",
     "coda",
     "confluence",  # not seeded
-    "contentful",
+    "contentful",  # not seeded
     "crustdata",
-    "dialpad",     # not seeded
+    "dialpad",  # not seeded
     "digitalocean",
     "domain_checker",
     "e2b",
@@ -66,14 +65,14 @@ ALL_APPS = [
     "rocketlane",
     "scraper",
     "semanticscholar",
-    "semrush",   # not seeded
+    "semrush",  # not seeded
     "sendgrid",
     "sentry",
     "serpapi",
     "sharepoint",  # not seeded
     "shopify",
     "shortcut",
-    "slack",    # not seeded
+    "slack",  # not seeded
     "spotify",
     "supabase",
     "tavily",
@@ -83,7 +82,7 @@ ALL_APPS = [
     "unipile",
     "whatsapp",
     "whatsapp_business",
-    "wrike",   # not seeded
+    "wrike",  # not seeded
     "yahoo_finance",
     "youtube",
     "zenquotes",