universal-mcp 0.1.13rc14__tar.gz → 0.1.15__tar.gz

universal_mcp-0.1.15/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Agentr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{universal_mcp-0.1.13rc14 → universal_mcp-0.1.15}/PKG-INFO

@@ -1,17 +1,20 @@
 Metadata-Version: 2.4
 Name: universal-mcp
-Version: 0.1.13rc14
+Version: 0.1.15
 Summary: Universal MCP acts as a middle ware for your API applications. It can store your credentials, authorize, enable disable apps on the fly and much more.
 Author-email: Manoj Bajaj <manojbajaj95@gmail.com>
 License: MIT
+License-File: LICENSE
 Requires-Python: >=3.11
 Requires-Dist: cookiecutter>=2.6.0
 Requires-Dist: gql[all]>=3.5.2
 Requires-Dist: jinja2>=3.1.3
+Requires-Dist: jsonref>=1.1.0
 Requires-Dist: keyring>=25.6.0
+Requires-Dist: langchain-mcp-adapters>=0.0.3
 Requires-Dist: litellm>=1.30.7
 Requires-Dist: loguru>=0.7.3
-Requires-Dist: mcp>=1.6.0
+Requires-Dist: mcp>=1.7.1
 Requires-Dist: posthog>=3.24.0
 Requires-Dist: pydantic-settings>=2.8.1
 Requires-Dist: pydantic>=2.11.1
@@ -26,10 +29,10 @@ Requires-Dist: pytest-asyncio>=0.26.0; extra == 'dev'
 Requires-Dist: pytest>=8.3.5; extra == 'dev'
 Requires-Dist: ruff>=0.11.4; extra == 'dev'
 Provides-Extra: playground
-Requires-Dist: langchain-mcp-adapters>=0.0.3; extra == 'playground'
 Requires-Dist: langchain-openai>=0.3.12; extra == 'playground'
 Requires-Dist: langgraph-checkpoint-sqlite>=2.0.6; extra == 'playground'
 Requires-Dist: langgraph>=0.3.24; extra == 'playground'
+Requires-Dist: litellm>=1.30.7; extra == 'playground'
 Requires-Dist: python-dotenv>=1.0.1; extra == 'playground'
 Requires-Dist: streamlit>=1.44.1; extra == 'playground'
 Requires-Dist: watchdog>=6.0.0; extra == 'playground'

{universal_mcp-0.1.13rc14 → universal_mcp-0.1.15}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "universal-mcp"
-version = "0.1.13-rc14"
+version = "0.1.15"
 description = "Universal MCP acts as a middle ware for your API applications. It can store your credentials, authorize, enable disable apps on the fly and much more."
 readme = "README.md"
 authors = [
@@ -16,10 +16,12 @@ dependencies = [
     "Jinja2>=3.1.3",
     "cookiecutter>=2.6.0",
     "gql[all]>=3.5.2",
+    "jsonref>=1.1.0",
     "keyring>=25.6.0",
+    "langchain-mcp-adapters>=0.0.3",
     "litellm>=1.30.7",
     "loguru>=0.7.3",
-    "mcp>=1.6.0",
+    "mcp>=1.7.1",
     "posthog>=3.24.0",
     "pydantic>=2.11.1",
     "pydantic-settings>=2.8.1",
@@ -38,13 +40,13 @@ dev = [
     "ruff>=0.11.4",
 ]
 playground = [
-    "langchain-mcp-adapters>=0.0.3",
     "langchain-openai>=0.3.12",
     "langgraph>=0.3.24",
     "langgraph-checkpoint-sqlite>=2.0.6",
     "python-dotenv>=1.0.1",
     "streamlit>=1.44.1",
     "watchdog>=6.0.0",
+    "litellm>=1.30.7",
 ]
 
 [project.scripts]
@@ -56,7 +58,6 @@ universal_mcp = "universal_mcp.cli:app"
 [tool.hatch.build.targets.sdist]
 include = [
     "/src",
-    "/templates", # Important: Include the templates directory!
 ]
 
 [tool.hatch.build.targets.wheel]

{universal_mcp-0.1.13rc14 → universal_mcp-0.1.15}/src/tests/test_api_generator.py

@@ -3,7 +3,7 @@ from pathlib import Path
 
 import pytest
 
-from universal_mcp.utils.api_generator import generate_api_from_schema
+from universal_mcp.utils.openapi.api_generator import generate_api_from_schema
 
 
 @pytest.fixture

universal_mcp-0.1.15/src/tests/test_applications.py

@@ -0,0 +1,90 @@
+import pytest
+from loguru import logger
+
+from universal_mcp.applications import app_from_slug
+from universal_mcp.tools.tools import Tool
+
+ALL_APPS = [
+    "ahrefs",
+    "airtable",
+    "apollo",
+    "asana",
+    # "box",
+    "braze",
+    "cal-com-v2",
+    "confluence",
+    "calendly",
+    "canva",
+    "clickup",
+    "coda",
+    "crustdata",
+    "e2b",
+    "elevenlabs",
+    "exa",
+    "falai",
+    "figma",
+    "firecrawl",
+    "github",
+    "gong",
+    "google-calendar",
+    "google-docs",
+    "google-drive",
+    "google-gemini",
+    "google-mail",
+    "google-sheet",
+    "hashnode",
+    "heygen",
+    # "jira",
+    "klaviyo",
+    "mailchimp",
+    "markitdown",
+    "miro",
+    "neon",
+    "notion",
+    "perplexity",
+    "pipedrive",
+    "posthog",
+    "reddit",
+    "replicate",
+    "resend",
+    "retell",
+    "rocketlane",
+    "serpapi",
+    "shopify",
+    "shortcut",
+    "spotify",
+    "supabase",
+    "tavily",
+    "trello",
+    "whatsapp-business",
+    "wrike",
+    "youtube",
+    "zenquotes",
+]
+
+
+@pytest.fixture
+def app(app_name):
+    return app_from_slug(app_name)
+
+
+class TestApplications:
+    @pytest.mark.parametrize(
+        "app_name",
+        ALL_APPS,
+    )
+    def test_application(self, app, app_name):
+        assert app is not None
+        app_instance = app(integration=None)
+        assert app_instance.name == app_name
+        tools = app_instance.list_tools()
+        logger.info(f"Tools for {app_name}: {len(tools)}")
+        assert len(tools) > 0, f"No tools found for {app_name}"
+        tools = [Tool.from_function(tool) for tool in tools]
+        important_tools = []
+        for tool in tools:
+            assert tool.name is not None
+            assert tool.description is not None
+            if "important" in tool.tags:
+                important_tools.append(tool.name)
+        assert len(important_tools) > 0, f"No important tools found for {app_name}"

{universal_mcp-0.1.13rc14 → universal_mcp-0.1.15}/src/tests/test_tool.py

@@ -3,6 +3,7 @@ from typing import Annotated
 from pydantic import Field
 
 from universal_mcp.tools.func_metadata import FuncMetadata
+from universal_mcp.tools.tools import Tool
 from universal_mcp.utils.docstring_parser import parse_docstring
 
 
@@ -23,6 +24,29 @@ def test_func_metadata_annotated():
     }
 
 
+def test_func_metadata_no_annotated():
+    def func(a: int, b: int):
+        """Test function with no annotated args
+
+        Args:
+            a: The first integer
+            b: The second integer
+        """
+        return a + b
+
+    tool = Tool.from_function(func)
+    meta = tool.fn_metadata
+    assert meta.arg_model.model_json_schema() == {
+        "type": "object",
+        "title": "funcArguments",
+        "properties": {
+            "a": {"type": "integer", "title": "The first integer"},
+            "b": {"type": "integer", "title": "The second integer"},
+        },
+        "required": ["a", "b"],
+    }
+
+
 def test_func_metadata_no_args():
     def func():
         """Test function with no args"""

{universal_mcp-0.1.13rc14 → universal_mcp-0.1.15}/src/universal_mcp/analytics.py

@@ -48,7 +48,12 @@ class Analytics:
             logger.error(f"Failed to track app_loaded event: {e}")
 
     def track_tool_called(
-        self, tool_name: str, status: str, error: str = None, user_id=None
+        self,
+        tool_name: str,
+        app_name: str,
+        status: str,
+        error: str = None,
+        user_id=None,
     ):
         """Track when a tool is called
 
@@ -63,6 +68,7 @@ class Analytics:
         try:
             properties = {
                 "tool_name": tool_name,
+                "app_name": app_name,
                 "status": status,
                 "error": error,
                 "version": self.get_version(),

universal_mcp-0.1.15/src/universal_mcp/applications/README.md

@@ -0,0 +1,122 @@
+# Universal MCP Applications Module
+
+This module provides the core functionality for managing and integrating applications within the Universal MCP system. It offers a flexible framework for creating, managing, and interacting with various types of applications through a unified interface.
+
+## Overview
+
+The applications module provides three main base classes for building application integrations:
+
+1. `BaseApplication`: The abstract base class that defines the common interface for all applications
+2. `APIApplication`: A concrete implementation for applications that communicate via HTTP APIs
+3. `GraphQLApplication`: A specialized implementation for applications that use GraphQL APIs
+
+## Key Features
+
+- **Dynamic Application Loading**: Applications can be loaded dynamically from external packages
+- **Unified Credential Management**: Centralized handling of application credentials
+- **HTTP API Support**: Built-in support for RESTful API interactions
+- **GraphQL Support**: Specialized support for GraphQL-based applications
+- **Automatic Package Installation**: Automatic installation of application packages from GitHub
+
+## Base Classes
+
+### BaseApplication
+
+The foundation class for all applications, providing:
+- Basic initialization
+- Credential management
+- Tool listing interface
+
+### APIApplication
+
+Extends BaseApplication to provide:
+- HTTP client management
+- Authentication handling
+- Common HTTP methods (GET, POST, PUT, DELETE, PATCH)
+- Request/response handling
+
+### GraphQLApplication
+
+Specialized for GraphQL-based applications, offering:
+- GraphQL client management
+- Query and mutation execution
+- Authentication handling
+
+## Usage
+
+### Creating a New Application
+
+1. Create a new package following the naming convention: `universal_mcp_<app_name>`
+2. Implement your application class inheriting from one of the base classes
+3. Name your class following the convention: `<AppName>App`
+
+Example:
+```python
+from universal_mcp.applications import APIApplication
+
+class MyApp(APIApplication):
+    def __init__(self, name: str, integration=None, **kwargs):
+        super().__init__(name, integration, **kwargs)
+        self.base_url = "https://api.example.com"
+
+    def list_tools(self):
+        return [self.my_tool]
+
+    def my_tool(self):
+        # Implementation here
+        pass
+```
+
+### Loading an Application
+
+```python
+from universal_mcp.applications import app_from_slug
+
+# The system will automatically install the package if needed
+MyApp = app_from_slug("my-app")
+app = MyApp("my-app-instance")
+```
+
+## Authentication
+
+The module supports various authentication methods:
+- API Keys
+- Access Tokens
+- Custom Headers
+- Bearer Tokens
+
+Credentials are managed through the integration system and can be accessed via the `credentials` property.
+
+## Error Handling
+
+The module includes comprehensive error handling for:
+- Package installation failures
+- Import errors
+- API request failures
+- Authentication issues
+
+## Logging
+
+All operations are logged using the `loguru` logger, providing detailed information about:
+- Application initialization
+- API requests
+- Authentication attempts
+- Package installation
+- Error conditions
+
+## Requirements
+
+- Python 3.8+
+- httpx
+- gql
+- loguru
+- uv (for package installation)
+
+## Contributing
+
+To contribute a new application:
+1. Create a new package following the naming conventions
+2. Implement the application class
+3. Add proper error handling and logging
+4. Include comprehensive documentation
+5. Submit a pull request to the Universal MCP repository

universal_mcp-0.1.15/src/universal_mcp/applications/__init__.py

@@ -0,0 +1,101 @@
+import importlib
+import os
+import subprocess
+import sys
+from importlib.metadata import version
+
+from loguru import logger
+
+from universal_mcp.applications.application import (
+    APIApplication,
+    BaseApplication,
+    GraphQLApplication,
+)
+from universal_mcp.utils.common import (
+    get_default_class_name,
+    get_default_module_path,
+    get_default_package_name,
+    get_default_repository_path,
+)
+
+UNIVERSAL_MCP_HOME = os.path.join(os.path.expanduser("~"), ".universal-mcp", "packages")
+
+if not os.path.exists(UNIVERSAL_MCP_HOME):
+    os.makedirs(UNIVERSAL_MCP_HOME)
+
+# set python path to include the universal-mcp home directory
+sys.path.append(UNIVERSAL_MCP_HOME)
+
+
+# Name are in the format of "app-name", eg, google-calendar
+# Class name is NameApp, eg, GoogleCalendarApp
+
+
+def _install_or_upgrade_package(package_name: str, repository_path: str):
+    """
+    Helper to install a package via pip from the universal-mcp GitHub repository.
+    """
+    try:
+        current_version = version(package_name)
+        logger.info(f"Current version of {package_name} is {current_version}")
+    except ImportError:
+        current_version = None
+    if current_version is not None:
+        return
+    cmd = [
+        "uv",
+        "pip",
+        "install",
+        "--upgrade",
+        repository_path,
+        "--target",
+        UNIVERSAL_MCP_HOME,
+    ]
+    logger.debug(f"Installing package '{package_name}' with command: {' '.join(cmd)}")
+    try:
+        subprocess.check_call(cmd)
+    except subprocess.CalledProcessError as e:
+        logger.error(f"Installation failed for '{package_name}': {e}")
+        raise ModuleNotFoundError(
+            f"Installation failed for package '{package_name}'"
+        ) from e
+    else:
+        logger.debug(f"Package {package_name} installed successfully")
+
+
+def app_from_slug(slug: str):
+    """
+    Dynamically resolve and return the application class for the given slug.
+    Attempts installation from GitHub if the package is not found locally.
+    """
+    class_name = get_default_class_name(slug)
+    module_path = get_default_module_path(slug)
+    package_name = get_default_package_name(slug)
+    repository_path = get_default_repository_path(slug)
+    logger.debug(
+        f"Resolving app for slug '{slug}' → module '{module_path}', class '{class_name}'"
+    )
+    try:
+        _install_or_upgrade_package(package_name, repository_path)
+        module = importlib.import_module(module_path)
+        class_ = getattr(module, class_name)
+        logger.debug(f"Loaded class '{class_}' from module '{module_path}'")
+        return class_
+    except ModuleNotFoundError as e:
+        raise ModuleNotFoundError(
+            f"Package '{module_path}' not found locally. Please install it first."
+        ) from e
+    except AttributeError as e:
+        raise AttributeError(
+            f"Class '{class_name}' not found in module '{module_path}'"
+        ) from e
+    except Exception as e:
+        raise Exception(f"Error importing module '{module_path}': {e}") from e
+
+
+__all__ = [
+    "app_from_slug",
+    "BaseApplication",
+    "APIApplication",
+    "GraphQLApplication",
+]