universal-mcp 0.1.8rc3__py3-none-any.whl → 0.1.8rc4__py3-none-any.whl

universal_mcp/applications/application.py

@@ -3,6 +3,7 @@ from abc import ABC, abstractmethod
 import httpx
 from loguru import logger
 
+from universal_mcp.analytics import analytics
 from universal_mcp.exceptions import NotAuthorizedError
 from universal_mcp.integrations import Integration
 
@@ -14,6 +15,8 @@ class Application(ABC):
 
     def __init__(self, name: str, **kwargs):
         self.name = name
+        logger.debug(f"Initializing Application '{name}' with kwargs: {kwargs}")
+        analytics.track_app_loaded(name)  # Track app loading
 
     @abstractmethod
     def list_tools(self):
@@ -29,17 +32,58 @@ class APIApplication(Application):
         super().__init__(name, **kwargs)
         self.default_timeout = 30
         self.integration = integration
+        logger.debug(
+            f"Initializing APIApplication '{name}' with integration: {integration}"
+        )
 
     def _get_headers(self):
+        if not self.integration:
+            logger.debug("No integration configured, returning empty headers")
+            return {}
+        credentials = self.integration.get_credentials()
+        logger.debug(f"Got credentials for integration: {credentials.keys()}")
+
+        # Check if direct headers are provided
+        headers = credentials.get("headers")
+        if headers:
+            logger.debug("Using direct headers from credentials")
+            return headers
+
+        # Check if api key is provided
+        api_key = (
+            credentials.get("api_key")
+            or credentials.get("API_KEY")
+            or credentials.get("apiKey")
+        )
+        if api_key:
+            logger.debug("Using API key from credentials")
+            return {
+                "Authorization": f"Bearer {api_key}",
+                "Content-Type": "application/json",
+            }
+
+        # Check if access token is provided
+        access_token = credentials.get("access_token")
+        if access_token:
+            logger.debug("Using access token from credentials")
+            return {
+                "Authorization": f"Bearer {access_token}",
+                "Content-Type": "application/json",
+            }
+        logger.debug("No authentication found in credentials, returning empty headers")
         return {}
 
     def _get(self, url, params=None):
         try:
             headers = self._get_headers()
+            logger.debug(f"Making GET request to {url} with params: {params}")
             response = httpx.get(
                 url, headers=headers, params=params, timeout=self.default_timeout
             )
             response.raise_for_status()
+            logger.debug(
+                f"GET request successful with status code: {response.status_code}"
+            )
             return response
         except NotAuthorizedError as e:
             logger.warning(f"Authorization needed: {e.message}")
@@ -51,6 +95,9 @@ class APIApplication(Application):
     def _post(self, url, data, params=None):
         try:
             headers = self._get_headers()
+            logger.debug(
+                f"Making POST request to {url} with params: {params} and data: {data}"
+            )
             response = httpx.post(
                 url,
                 headers=headers,
@@ -59,12 +106,16 @@ class APIApplication(Application):
                 timeout=self.default_timeout,
             )
             response.raise_for_status()
+            logger.debug(
+                f"POST request successful with status code: {response.status_code}"
+            )
             return response
         except NotAuthorizedError as e:
             logger.warning(f"Authorization needed: {e.message}")
             raise e
         except httpx.HTTPStatusError as e:
             if e.response.status_code == 429:
+                logger.warning(f"Rate limit exceeded for {url}")
                 return e.response.text or "Rate limit exceeded. Please try again later."
             else:
                 raise e
@@ -75,6 +126,9 @@ class APIApplication(Application):
     def _put(self, url, data, params=None):
         try:
             headers = self._get_headers()
+            logger.debug(
+                f"Making PUT request to {url} with params: {params} and data: {data}"
+            )
             response = httpx.put(
                 url,
                 headers=headers,
@@ -83,6 +137,9 @@ class APIApplication(Application):
                 timeout=self.default_timeout,
             )
             response.raise_for_status()
+            logger.debug(
+                f"PUT request successful with status code: {response.status_code}"
+            )
             return response
         except NotAuthorizedError as e:
             logger.warning(f"Authorization needed: {e.message}")
@@ -94,10 +151,14 @@ class APIApplication(Application):
     def _delete(self, url, params=None):
         try:
             headers = self._get_headers()
+            logger.debug(f"Making DELETE request to {url} with params: {params}")
             response = httpx.delete(
                 url, headers=headers, params=params, timeout=self.default_timeout
             )
             response.raise_for_status()
+            logger.debug(
+                f"DELETE request successful with status code: {response.status_code}"
+            )
             return response
         except NotAuthorizedError as e:
             logger.warning(f"Authorization needed: {e.message}")
@@ -109,6 +170,9 @@ class APIApplication(Application):
     def _patch(self, url, data, params=None):
         try:
             headers = self._get_headers()
+            logger.debug(
+                f"Making PATCH request to {url} with params: {params} and data: {data}"
+            )
             response = httpx.patch(
                 url,
                 headers=headers,
@@ -117,6 +181,9 @@ class APIApplication(Application):
                 timeout=self.default_timeout,
             )
             response.raise_for_status()
+            logger.debug(
+                f"PATCH request successful with status code: {response.status_code}"
+            )
             return response
         except NotAuthorizedError as e:
             logger.warning(f"Authorization needed: {e.message}")

universal_mcp/applications/calendly/app.py

@@ -19,18 +19,6 @@ class CalendlyApp(APIApplication):
         super().__init__(name="calendly", integration=integration, **kwargs)
         self.base_url = "https://api.calendly.com"
 
-    def _get_headers(self):
-        if not self.integration:
-            raise ValueError("Integration not configured for CalendlyApp")
-        credentials = self.integration.get_credentials()
-
-        if "headers" in credentials:
-            return credentials["headers"]
-        return {
-            "Authorization": f"Bearer {credentials['access_token']}",
-            "Content-Type": "application/json",
-        }
-
     def list_event_invitees(
         self, uuid, status=None, sort=None, email=None, page_token=None, count=None
     ) -> dict[str, Any]:

universal_mcp/applications/coda/app.py

@@ -1,7 +1,5 @@
 from typing import Any
 
-from loguru import logger
-
 from universal_mcp.applications import APIApplication
 from universal_mcp.integrations import Integration
 
@@ -10,37 +8,6 @@ class CodaApp(APIApplication):
     def __init__(self, integration: Integration = None, **kwargs) -> None:
         super().__init__(name="coda", integration=integration, **kwargs)
         self.base_url = "https://coda.io/apis/v1"
-        self.api_key: str | None = None
-
-    def _set_api_key(self):
-        if self.api_key:
-            return
-
-        if not self.integration:
-            raise ValueError("Integration is None. Cannot retrieve Coda API Key.")
-
-        credentials = self.integration.get_credentials()
-        if not credentials:
-            raise ValueError(
-                f"Failed to retrieve Coda API Key using integration '{self.integration.name}'. "
-            )
-        api_key = (
-            credentials.get("api_key")
-            or credentials.get("API_KEY")
-            or credentials.get("apiKey")
-        )
-        if not api_key:
-            raise ValueError("Coda API Key not found in credentials.")
-        self.api_key = api_key
-
-    def _get_headers(self) -> dict[str, str]:
-        self._set_api_key()
-        logger.info(f"Coda API Key: {self.api_key}")
-        return {
-            "Authorization": f"Bearer {self.api_key}",
-            "Content-Type": "application/json",
-            "Accept": "application/json",
-        }
 
     def list_categories(
         self,

universal_mcp/applications/e2b/app.py

@@ -1,7 +1,6 @@
 from typing import Annotated
 
 from e2b_code_interpreter import Sandbox
-from loguru import logger
 
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
@@ -15,31 +14,6 @@ class E2BApp(APIApplication):
 
     def __init__(self, integration: Integration | None = None) -> None:
         super().__init__(name="e2b", integration=integration)
-        self.api_key: str | None = None
-
-    def _set_api_key(self):
-        if self.api_key:
-            return
-
-        if not self.integration:
-            raise ValueError("Integration is None. Cannot retrieve E2B API Key.")
-
-        credentials = self.integration.get_credentials()
-        if not credentials:
-            raise ValueError(
-                f"Invalid credential format received for E2B API Key via integration '{self.integration.name}'. "
-            )
-        api_key = (
-            credentials.get("api_key")
-            or credentials.get("API_KEY")
-            or credentials.get("apiKey")
-        )
-        if not api_key:
-            raise ValueError(
-                f"Invalid credential format received for E2B API Key via integration '{self.integration.name}'. "
-            )
-        self.api_key = api_key
-        logger.info("E2B API Key successfully retrieved via integration.")
 
     def _format_execution_output(self, logs) -> str:
         """Helper function to format the E2B execution logs nicely."""
@@ -79,8 +53,8 @@ class E2BApp(APIApplication):
         Tags:
             execute, sandbox, code-execution, security, important
         """
-        self._set_api_key()
-        with Sandbox(api_key=self.api_key) as sandbox:
+        api_key = self.integration.get_credentials().get("api_key")
+        with Sandbox(api_key=api_key) as sandbox:
             execution = sandbox.run_code(code=code)
             result = self._format_execution_output(execution.logs)
             return result

universal_mcp/applications/figma/README.md

@@ -0,0 +1,74 @@
+
+# Figma MCP Server
+
+An MCP Server for the Figma API.
+
+## Supported Integrations
+
+- AgentR
+- API Key (Coming Soon)
+- OAuth (Coming Soon)
+
+## Tools
+
+This is automatically generated from OpenAPI schema for the Figma API.
+
+## Supported Integrations
+
+This tool can be integrated with any service that supports HTTP requests.
+
+## Tool List
+
+| Tool | Description |
+|------|-------------|
+| get_file | Retrieves file metadata and content from the API using the specified file key and optional query parameters. |
+| get_file_nodes | Fetches node data for specified IDs from a file, supporting optional filters such as version, depth, geometry, and plugin data. |
+| get_images | Retrieves image assets from a remote service for specified node IDs within a given file, with optional image format and export options. |
+| get_image_fills | Retrieves image fill data for a given file key from the API. |
+| get_team_projects | Retrieves the list of projects associated with a specified team. |
+| get_project_files | Retrieves the list of files associated with a specified project, optionally filtered by branch data. |
+| get_file_versions | Retrieves a paginated list of version history for a specified file. |
+| get_comments | Retrieves comments for a specified file, optionally formatting the output as Markdown. |
+| post_comment | Posts a comment to a specified file. |
+| delete_comment | Deletes a specific comment from a file identified by its key and comment ID. |
+| get_comment_reactions | Retrieves the reactions associated with a specific comment in a file. |
+| post_comment_reaction | Posts a reaction emoji to a specific comment on a file. |
+| delete_comment_reaction | Removes a specific emoji reaction from a comment in a file. |
+| get_me | Retrieves information about the authenticated user from the API. |
+| get_team_components | Retrieves a paginated list of components associated with a specified team. |
+| get_file_components | Retrieves the component information for a specified file from the API. |
+| get_component | Retrieves a component's details by its key from the API. |
+| get_team_component_sets | Retrieves a paginated list of component sets for a specified team. |
+| get_file_component_sets | Retrieves the list of component sets associated with a specific file key. |
+| get_component_set | Retrieves a component set resource by its key from the server. |
+| get_team_styles | Retrieves a list of styles for a specified team, with optional pagination controls. |
+| get_file_styles | Retrieves the style definitions for a specified file from the API. |
+| get_style | Retrieves a style resource identified by the given key from the API. |
+| post_webhook | Registers a new webhook for a specified event type and team. |
+| get_webhook | Retrieves the details of a specific webhook by its unique identifier. |
+| put_webhook | Update an existing webhook's configuration with new settings such as event type, endpoint, passcode, status, or description. |
+| delete_webhook | Deletes a webhook with the specified webhook ID. |
+| get_team_webhooks | Retrieves the list of webhooks configured for a given team. |
+| get_webhook_requests | Retrieves the list of requests for a specified webhook. |
+| get_activity_logs | Retrieves activity logs from the API with optional filters for events, time range, limit, and order. |
+| get_payments | Retrieves a list of payments based on the provided filter criteria. |
+| get_local_variables | Retrieves the local variables associated with a specific file identified by file_key. |
+| get_published_variables | Retrieves the published variables associated with a specified file key from the server. |
+| post_variables | Posts or updates variable data for a specified file by sending a POST request to the variables endpoint. |
+| get_dev_resources | Retrieves development resources for a specific file. |
+| post_dev_resources | Submits developer resources to the API and returns the parsed JSON response. |
+| put_dev_resources | Updates the development resources by sending a PUT request to the dev_resources endpoint. |
+| delete_dev_resource | Deletes a specific development resource associated with a file. |
+
+
+
+## Usage
+
+- Login to AgentR
+- Follow the quickstart guide to setup MCP Server for your client
+- Visit Apps Store and enable the Figma app
+- Restart the MCP Server
+
+### Local Development
+
+- Follow the README to test with the local MCP Server