universal-mcp 0.1.23rc1__tar.gz → 0.1.24rc2__tar.gz

universal_mcp-0.1.24rc2/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: universal-mcp
+Version: 0.1.24rc2
+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: black>=25.1.0
+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: loguru>=0.7.3
+Requires-Dist: mcp>=1.9.3
+Requires-Dist: posthog>=3.24.0
+Requires-Dist: pydantic-settings>=2.8.1
+Requires-Dist: pydantic>=2.11.1
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: rich>=14.0.0
+Requires-Dist: typer>=0.15.2
+Provides-Extra: dev
+Requires-Dist: litellm>=1.30.7; extra == 'dev'
+Requires-Dist: mypy>=1.16.0; extra == 'dev'
+Requires-Dist: pre-commit>=4.2.0; extra == 'dev'
+Requires-Dist: pyright>=1.1.398; extra == 'dev'
+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'
+Description-Content-Type: text/markdown
+
+# Universal MCP
+
+Universal MCP acts as a middleware layer for your API applications, enabling seamless integration with various services through the Model Control Protocol (MCP). It simplifies credential management, authorization, dynamic app enablement, and provides a robust framework for building and managing AI-powered tools.
+
+## Documentation
+
+The primary documentation for Universal MCP is available in `/docs` folder in this repository.
+
+Please refer to the following for more detailed information:
+
+*   **[Main Documentation](docs/index.md)**: For an overview of the project, features, quick start, and installation.
+*   **[Playground Usage](docs/playground.md)**: For instructions on using the interactive playground.
+*   **[Applications Framework](docs/applications.md)**: For details on the applications module.
+*   **[Integrations & Authentication](docs/integrations.md)**: For information on integration types.
+*   **[Server Implementations](docs/servers.md)**: For details on server types.
+*   **[Credential Stores](docs/stores.md)**: For information on credential stores.
+*   **[Tools Framework](docs/tools_framework.md)**: For details on the tool management system.
+*   **[Contributing Guidelines](CONTRIBUTING.md)**: For information on how to contribute to the project.
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

universal_mcp-0.1.24rc2/README.md

@@ -0,0 +1,22 @@
+# Universal MCP
+
+Universal MCP acts as a middleware layer for your API applications, enabling seamless integration with various services through the Model Control Protocol (MCP). It simplifies credential management, authorization, dynamic app enablement, and provides a robust framework for building and managing AI-powered tools.
+
+## Documentation
+
+The primary documentation for Universal MCP is available in `/docs` folder in this repository.
+
+Please refer to the following for more detailed information:
+
+*   **[Main Documentation](docs/index.md)**: For an overview of the project, features, quick start, and installation.
+*   **[Playground Usage](docs/playground.md)**: For instructions on using the interactive playground.
+*   **[Applications Framework](docs/applications.md)**: For details on the applications module.
+*   **[Integrations & Authentication](docs/integrations.md)**: For information on integration types.
+*   **[Server Implementations](docs/servers.md)**: For details on server types.
+*   **[Credential Stores](docs/stores.md)**: For information on credential stores.
+*   **[Tools Framework](docs/tools_framework.md)**: For details on the tool management system.
+*   **[Contributing Guidelines](CONTRIBUTING.md)**: For information on how to contribute to the project.
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

{universal_mcp-0.1.23rc1 → universal_mcp-0.1.24rc2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "universal-mcp"
-version = "0.1.23-rc1"
+version = "0.1.24-rc2"
 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 = [
@@ -19,10 +19,8 @@ dependencies = [
     "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.9.0",
+    "mcp>=1.9.3",
     "posthog>=3.24.0",
     "pydantic>=2.11.1",
     "pydantic-settings>=2.8.1",
@@ -33,6 +31,7 @@ dependencies = [
 
 [project.optional-dependencies]
 dev = [
+    "mypy>=1.16.0",
     "litellm>=1.30.7",
     "pre-commit>=4.2.0",
     "pyright>=1.1.398",
@@ -40,15 +39,6 @@ dev = [
     "pytest-asyncio>=0.26.0",
     "ruff>=0.11.4",
 ]
-playground = [
-    "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]
 universal_mcp = "universal_mcp.cli:app"
@@ -71,34 +61,6 @@ packages = ["src/universal_mcp"]
 # Tool configurations
 # ------------------------------
 [tool.ruff]
-exclude = [
-    ".bzr",
-    ".direnv",
-    ".eggs",
-    ".git",
-    ".git-rewrite",
-    ".hg",
-    ".ipynb_checkpoints",
-    ".mypy_cache",
-    ".nox",
-    ".pants.d",
-    ".pyenv",
-    ".pytest_cache",
-    ".pytype",
-    ".ruff_cache",
-    ".svn",
-    ".tox",
-    ".venv",
-    ".vscode",
-    "__pypackages__",
-    "_build",
-    "buck-out",
-    "build",
-    "dist",
-    "node_modules",
-    "site-packages",
-    "venv",
-]
 line-length = 120
 indent-width = 4
 target-version = "py312"
@@ -127,3 +89,8 @@ docstring-code-line-length = "dynamic"
 [tool.pytest.ini_options]
 asyncio_mode = "strict"
 asyncio_default_fixture_loop_scope = "function"
+
+[tool.mypy]
+exclude = [
+    '^src/universal_mcp/utils/openapi/\.*',
+]

{universal_mcp-0.1.23rc1 → universal_mcp-0.1.24rc2}/src/tests/test_applications.py

@@ -6,6 +6,7 @@ from universal_mcp.utils.testing import check_application_instance
 ALL_APPS = [
     "ahrefs",
     "airtable",
+    "aws-s3",
     "apollo",
     "asana",
     "box",
@@ -39,6 +40,7 @@ ALL_APPS = [
     "mailchimp",
     "markitdown",
     "miro",
+    "ms-teams",
     "neon",
     "notion",
     "perplexity",
@@ -50,6 +52,7 @@ ALL_APPS = [
     "retell",
     "rocketlane",
     "serpapi",
+    "sharepoint",
     "shopify",
     "shortcut",
     "spotify",

{universal_mcp-0.1.23rc1 → universal_mcp-0.1.24rc2}/src/tests/test_tool.py

@@ -3,9 +3,9 @@ from typing import Annotated
 
 from pydantic import Field
 
+from universal_mcp.tools.docstring_parser import parse_docstring  # Assuming this is the updated one
 from universal_mcp.tools.func_metadata import FuncMetadata
 from universal_mcp.tools.tools import Tool
-from universal_mcp.utils.docstring_parser import parse_docstring  # Assuming this is the updated one
 
 
 def test_func_metadata_annotated():

universal_mcp-0.1.24rc2/src/universal_mcp/analytics.py

@@ -0,0 +1,113 @@
+import os
+import uuid
+from functools import lru_cache
+from importlib.metadata import version
+
+import posthog
+from loguru import logger
+
+
+class Analytics:
+    """A singleton class for tracking analytics events using PostHog.
+
+    This class handles the initialization of the PostHog client and provides
+    methods to track key events such as application loading and tool execution.
+    Telemetry can be disabled by setting the TELEMETRY_DISABLED environment
+    variable to "true".
+    """
+
+    _instance = None
+
+    def __new__(cls):
+        if cls._instance is None:
+            cls._instance = super().__new__(cls)
+            cls._instance._initialize()
+        return cls._instance
+
+    def _initialize(self):
+        """Initializes the PostHog client and sets up analytics properties.
+
+        This internal method configures the PostHog API key and host.
+        It also determines if analytics should be enabled based on the
+        TELEMETRY_DISABLED environment variable and generates a unique
+        user ID.
+        """
+        posthog.host = "https://us.i.posthog.com"
+        posthog.api_key = "phc_6HXMDi8CjfIW0l04l34L7IDkpCDeOVz9cOz1KLAHXh8"
+        self.enabled = os.getenv("TELEMETRY_DISABLED", "false").lower() != "true"
+        self.user_id = str(uuid.uuid4())[:8]
+
+    @staticmethod
+    @lru_cache(maxsize=1)
+    def get_version():
+        """Retrieves the installed version of the universal_mcp package.
+
+        Uses importlib.metadata to get the package version.
+        Caches the result for efficiency.
+
+        Returns:
+            str: The package version string, or "unknown" if not found.
+        """
+        try:
+            return version("universal_mcp")
+        except ImportError:  # Should be PackageNotFoundError, but matching existing code
+            return "unknown"
+
+    def track_app_loaded(self, app_name: str):
+        """Tracks an event when an application is successfully loaded.
+
+        This event helps understand which applications are being utilized.
+
+        Args:
+            app_name (str): The name of the application that was loaded.
+        """
+        if not self.enabled:
+            return
+        try:
+            properties = {
+                "version": self.get_version(),
+                "app_name": app_name,
+            }
+            posthog.capture(self.user_id, "app_loaded", properties)
+        except Exception as e:
+            logger.error(f"Failed to track app_loaded event: {e}")
+
+    def track_tool_called(
+        self,
+        tool_name: str,
+        app_name: str,
+        status: str,
+        error: str = None,
+        user_id=None,  # Note: user_id is captured in PostHog but not used from this param
+    ):
+        """Tracks an event when a tool is called within an application.
+
+        This event provides insights into tool usage patterns, success rates,
+        and potential errors.
+
+        Args:
+            tool_name (str): The name of the tool that was called.
+            app_name (str): The name of the application the tool belongs to.
+            status (str): The status of the tool call (e.g., "success", "error").
+            error (str, optional): The error message if the tool call failed.
+                                 Defaults to None.
+            user_id (str, optional): An optional user identifier.
+                                   Note: Currently, the class uses an internally
+                                   generated user_id for PostHog events.
+        """
+        if not self.enabled:
+            return
+        try:
+            properties = {
+                "tool_name": tool_name,
+                "app_name": app_name,
+                "status": status,
+                "error": error,
+                "version": self.get_version(),
+            }
+            posthog.capture(self.user_id, "tool_called", properties)
+        except Exception as e:
+            logger.error(f"Failed to track tool_called event: {e}")
+
+
+analytics = Analytics()