universal-mcp-applications 0.1.12__tar.gz → 0.1.36rc4__tar.gz

universal_mcp_applications-0.1.36rc4/.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.36rc4/GEMINI.md

@@ -0,0 +1,125 @@
+# Agent.md — Python + uv
+
+Purpose
+- This repository uses Python managed by uv for dependency resolution, virtual environments, locking, and execution. Always prefer uv subcommands (add/remove/run/sync/export) over raw pip/venv commands.
+
+Core rules
+- Use `uv add` to add or upgrade dependencies so that both `pyproject.toml` and `uv.lock` stay in sync; do not use `pip install` directly.
+- Keep runtime dependencies in `[project.dependencies]` and development-only tools in the `dev` group via `uv add --dev ...`.
+- Use `uv run` to execute Python, test, and tooling commands without manually activating a virtual environment.
+
+Project bootstrap
+- New project (scaffold files): `uv init`
+- First install or clean install: `uv sync`
+- Run the app: `uv run python -m <your_module>` or `uv run main.py`
+- REPL: `uv run python`
+- Scripts in pyproject: prefer `uv run <command>` to ensure the correct environment is used
+
+Managing dependencies
+- Add runtime dependency: `uv add <name>` (e.g., `uv add httpx`)
+- Add dev dependencies: `uv add --dev pytest ruff`
+- Pin/upgrade by constraint: `uv add "httpx>=0.27"` or adjust `pyproject.toml` and then `uv sync`
+- Remove dependency: `uv remove <name>`
+- Export lock for external tooling: `uv export --format requirements-txt --output-file requirements.txt`
+
+Locking and environments
+- `uv run` and `uv sync` will ensure the environment matches `pyproject.toml` and `uv.lock`
+- Avoid manual `pip install` or manual `venv` activation; let uv manage the environment
+- Commit `uv.lock` to version control for reproducible installs
+
+pyproject guidance
+- Dependencies live under `[project]` → `dependencies = [...]`
+- Development-only tooling should go under a dev group (e.g., `uv add --dev ruff pytest`) for clean separation
+- Keep `requires-python` current (e.g., `>=3.12`) to match the team’s baseline
+
+Usage in this repo
+- When adding libraries or changing versions, propose `uv add ...` changes that update both `pyproject.toml` and `uv.lock`, then run `uv run pytest -q` to validate
+- Prefer minimal diffs, explain the plan, apply changes, and run tests/tooling via `uv run`
+- If build/test fails, inspect error context, adjust constraints or code, and re-run via `uv run`
+
+Common commands (copy/paste)
+- Initialize: `uv init`  |  Install deps: `uv sync`
+- Add runtime: `uv add <pkg>`  |  Add dev: `uv add --dev <pkg>`
+- Remove: `uv remove <pkg>`
+- Run app: `uv run python -m <your_module>` or `uv run main.py`
+- Tests: `uv run pytest -q`
+- Lint/format: `uv run ruff check .` and/or `uv run ruff format .`
+- Export: `uv export --format requirements-txt --output-file requirements.txt`
+
+Of course. Based on your request and the example `app.py` you provided, here is a new section that you can append to your `gemini.md` file. This section provides clear guidance on how to write effective tool names and descriptions, using the Perplexity `chat` function as a concrete example.
+
+The proposed changes will make the function's purpose much clearer, especially its ability to access and cite real-time web information, which is a key feature.
+
+***
+
+### Tool Function Naming and Descriptions
+
+To ensure the AI agent can effectively understand and use the tools available, function names and their descriptions (docstrings) must be clear, descriptive, and accurate. A good description outlines the tool's purpose, its key capabilities, and what it returns.
+
+**Core Principles:**
+- **Use Action-Oriented Names:** Function names should be verbs that clearly state what the tool *does* (e.g., `search`, `create_file`, `list_users`).
+- **Be Specific in Descriptions:** The docstring is the primary source of context for the AI. It should explicitly mention the service it interacts with (e.g., "Perplexity AI") and its unique features (e.g., "performs real-time web searches," "provides citations").
+- **Detail Inputs and Outputs:** Clearly describe the purpose of each argument and what the function returns, as this helps the agent formulate correct calls.
+
+**Example: Improving the Perplexity Tool**
+
+Let's refine the tool in `app.py` to be more descriptive and unlock its full potential. The original `chat` function is too generic. We will rename it to `search` and significantly improve its docstring.
+
+**BEFORE:** The original function name and description are too simple.
+
+```python
+# from app.py
+def chat(
+    self,
+    query: str,
+    model: Literal[...] = "sonar",
+    temperature: float = 1,
+    system_prompt: str = "Be precise and concise.",
+) -> dict[str, Any] | str:
+    """
+    Initiates a chat completion request to generate AI responses using various models with customizable parameters.
+    ...
+    Tags:
+        chat, generate, ai, completion, important
+    """
+```
+
+**AFTER:** The updated name and description are highly specific, highlighting the core web search and citation capabilities. Do not leave any empty lines between the descriptions.
+
+```python
+# from app.py
+def search(
+    self,
+    query: str,
+    model: Literal[
+        "r1-1776",
+        "sonar",
+        "sonar-pro",
+        "sonar-reasoning",
+        "sonar-reasoning-pro",
+        "sonar-deep-research",
+    ] = "sonar-pro",
+    temperature: float = 1,
+    system_prompt: str = "You are a helpful AI assistant that answers questions using real-time information from the web.",
+) -> dict[str, Any] | str:
+    """
+    Performs a real-time web search using Perplexity AI to answer a query with up-to-date information and citations.
+    This tool is ideal for questions about current events, facts, or any topic that requires access to the latest information from the internet. It returns a natural language answer along with the sources used.
+
+    Args:
+        query: The search query or question to ask. For example: "What are the latest developments in AI regulation?"
+        model: The Perplexity model to use. 'sonar-pro' is recommended for comprehensive, up-to-date answers.
+        temperature: Controls randomness in the model's output. Higher values make the output more random, lower values make it more deterministic. Defaults to 1.
+        system_prompt: The initial system message to guide the model's behavior.
+
+    Returns:
+        A dictionary containing the generated 'content' (str) and a list of 'citations' (list) from the web search.
+
+    Raises:
+        AuthenticationError: Raised when API authentication fails due to missing or invalid credentials.
+        HTTPError: Raised when the API request fails or returns an error status.
+
+    Tags:
+        search, web, research, citations, current events, important
+    """
+```

{universal_mcp_applications-0.1.12 → universal_mcp_applications-0.1.36rc4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: universal-mcp-applications
-Version: 0.1.12
+Version: 0.1.36rc4
 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
@@ -22,7 +23,7 @@ Requires-Dist: google-genai>=1.33.0
 Requires-Dist: google-search-results>=2.4.2
 Requires-Dist: gql[all]>=3.5.2
 Requires-Dist: httpx-aiohttp>=0.1.8
-Requires-Dist: markitdown[audio-transcription,az-doc-intel,docx,outlook,pdf,pptx,xls,xlsx]==0.1.3
+Requires-Dist: markitdown[audio-transcription,az-doc-intel,docx,outlook,pdf,pptx,xls,xlsx]>=0.1.3
 Requires-Dist: office365-rest-python-client>=2.6.2
 Requires-Dist: openai>=1.75.0
 Requires-Dist: pyairtable>=3.1.1
@@ -34,7 +35,8 @@ Requires-Dist: replicate>=1.0.6
 Requires-Dist: requests>=2.31.0
 Requires-Dist: resend>=2.10.0
 Requires-Dist: twilio>=9.8.0
-Requires-Dist: universal-mcp>=0.1.24rc19
+Requires-Dist: universal-mcp>=0.1.24rc29
+Requires-Dist: yfinance>=0.2.66
 Requires-Dist: youtube-transcript-api==1.2.2
 Provides-Extra: dev
 Requires-Dist: pre-commit; extra == 'dev'
@@ -85,91 +87,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.12 → universal_mcp_applications-0.1.36rc4}/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.12 → universal_mcp_applications-0.1.36rc4}/bump_and_release.sh

@@ -81,7 +81,6 @@ if [ "$1" = "release" ]; then
     rm -rf .pytest_cache
     rm -rf .ruff_cache
     rm -rf .mypy_cache
-    rm -rf .venv
     rm -rf .cache
     rm -rf .DS_Store
     rm -rf .idea

{universal_mcp_applications-0.1.12 → universal_mcp_applications-0.1.36rc4}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "universal-mcp-applications"
-version = "0.1.12"
+version = "0.1.36-rc4"
 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",
@@ -30,7 +31,7 @@ dependencies = [
     "google-search-results>=2.4.2",
     "gql[all]>=3.5.2",
     "httpx-aiohttp>=0.1.8",
-    "markitdown[audio-transcription,az-doc-intel,docx,outlook,pdf,pptx,xls,xlsx]==0.1.3",
+    "markitdown[audio-transcription,az-doc-intel,docx,outlook,pdf,pptx,xls,xlsx]>=0.1.3",
     "office365-rest-python-client>=2.6.2",
     "openai>=1.75.0",
     "pyairtable>=3.1.1",
@@ -42,7 +43,8 @@ dependencies = [
     "requests>=2.31.0",
     "resend>=2.10.0",
     "twilio>=9.8.0",
-    "universal-mcp>=0.1.24rc19",
+    "universal-mcp>=0.1.24rc29",
+    "yfinance>=0.2.66",
     "youtube-transcript-api==1.2.2",
 ]
 
@@ -75,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",
@@ -83,7 +84,7 @@ packages = [
 
 [tool.coverage.run]
 source = [
-    "src",   
+    "src",
 ]
 branch = true
 
@@ -92,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"
@@ -107,3 +107,8 @@ pythonpath = [
     "src",
 ]
 
+[dependency-groups]
+dev = [
+    "litellm>=1.77.3",
+    "universal-mcp-agents>=0.1.13",
+]

universal_mcp_applications-0.1.36rc4/src/scripts/check_internal_calls.py

@@ -0,0 +1,195 @@
+import ast
+import os
+
+# List of applications to be checked for internal calls
+APPS = [
+    "ahrefs",
+    "airtable",
+    "apollo",
+    "asana",
+    "aws_s3",
+    "bill",  # not seeded
+    "box",
+    "braze",
+    # "cal_com_v2",   # not seeded
+    "calendly",
+    "canva",
+    "clickup",
+    "coda",
+    "confluence",  # not seeded
+    "contentful",  # not seeded
+    "crustdata",
+    "dialpad",  # not seeded
+    "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",
+    "onedrive",
+    "openai",
+    "outlook",
+    "perplexity",
+    "pipedrive",  # not seeded
+    "posthog",
+    "reddit",
+    "resend",
+    "retell",
+    "rocketlane",
+    "scraper",
+    "semanticscholar",
+    "semrush",  # not seeded
+    "sendgrid",
+    "sentry",
+    "serpapi",
+    "sharepoint",
+    "shopify",
+    "shortcut",
+    "slack",
+    "spotify",  # not seeded
+    "supabase",
+    "tavily",
+    "trello",
+    "twilio",
+    "twitter",
+    "whatsapp",
+    "whatsapp_business",
+    "wrike",  # not seeded
+    "yahoo_finance",
+    "youtube",
+    "zenquotes",
+]
+
+
+class InternalCallFinder(ast.NodeVisitor):
+    """
+    An AST visitor that finds calls to tool functions from within other tool functions.
+    """
+
+    def __init__(self, tool_functions):
+        self.tool_functions = set(tool_functions)
+        self.current_function = None
+        self.internal_calls = []
+
+    def visit_FunctionDef(self, node):
+        if node.name in self.tool_functions:
+            self.current_function = node.name
+            self.generic_visit(node)
+            self.current_function = None
+        else:
+            self.generic_visit(node)
+
+    def visit_AsyncFunctionDef(self, node):
+        if node.name in self.tool_functions:
+            self.current_function = node.name
+            self.generic_visit(node)
+            self.current_function = None
+        else:
+            self.generic_visit(node)
+
+    def visit_Call(self, node):
+        if self.current_function:
+            if isinstance(node.func, ast.Attribute) and isinstance(node.func.value, ast.Name) and node.func.value.id == "self":
+                called_func_name = node.func.attr
+                if called_func_name in self.tool_functions and called_func_name != self.current_function:
+                    self.internal_calls.append({"caller": self.current_function, "callee": called_func_name})
+        self.generic_visit(node)
+
+
+def get_tool_function_names(tree):
+    """
+    Extracts the names of the tool functions from the 'list_tools' method in the AST.
+    """
+    tool_functions = set()
+    for node in ast.walk(tree):
+        if isinstance(node, ast.ClassDef):
+            for item in node.body:
+                if isinstance(item, ast.FunctionDef) and item.name == "list_tools":
+                    for statement in item.body:
+                        if isinstance(statement, ast.Return):
+                            if isinstance(statement.value, (ast.List, ast.Tuple)):
+                                for elt in statement.value.elts:
+                                    if isinstance(elt, ast.Attribute):
+                                        tool_functions.add(elt.attr)
+    return list(tool_functions)
+
+
+def process_file(file_path):
+    """
+    Reads and processes a single app.py file to find internal calls.
+    """
+    with open(file_path, "r") as f:
+        source = f.read()
+    try:
+        tree = ast.parse(source)
+    except SyntaxError as e:
+        print(f"Error parsing {file_path}: {e}")
+        return []
+
+    tool_functions = get_tool_function_names(tree)
+    if not tool_functions:
+        return []
+
+    finder = InternalCallFinder(tool_functions)
+    finder.visit(tree)
+    return finder.internal_calls
+
+
+def main():
+    """
+    Main function to iterate through specified applications and check for internal calls.
+    """
+    base_path = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "universal_mcp", "applications"))
+
+    apps_with_internal_calls = {}
+
+    for app in APPS:
+        app_path = os.path.join(base_path, app, "app.py")
+        if os.path.exists(app_path):
+            internal_calls = process_file(app_path)
+            if internal_calls:
+                apps_with_internal_calls[app] = internal_calls
+        else:
+            print(f"Could not find {app_path} for application {app}")
+
+    if apps_with_internal_calls:
+        print("Applications with internal tool function calls:")
+        for app, calls in apps_with_internal_calls.items():
+            print(f"- {app}:")
+            unique_calls = {(call["caller"], call["callee"]) for call in calls}
+            for caller, callee in sorted(list(unique_calls)):
+                print(f"  - '{caller}' calls '{callee}'")
+    else:
+        print("No applications with internal tool function calls found in the specified APPS list.")
+
+
+if __name__ == "__main__":
+    main()