universal-mcp 0.1.13rc1__py3-none-any.whl → 0.1.13rc2__py3-none-any.whl

universal_mcp/applications/falai/README.md

@@ -1,42 +0,0 @@
-
-# Falai MCP Server
-
-An MCP Server for the Falai API.
-
-## Supported Integrations
-
-- AgentR
-- API Key (Coming Soon)
-- OAuth (Coming Soon)
-
-## Tools
-
-This is automatically generated from OpenAPI schema for the Falai API.
-
-## Supported Integrations
-
-This tool can be integrated with any service that supports HTTP requests.
-
-## Tool List
-
-| Tool | Description |
-|------|-------------|
-| run | Run a Fal AI application directly and wait for the result. Suitable for short-running applications with synchronous execution from the caller's perspective. |
-| submit | Submits a request to the Fal AI queue for asynchronous processing and returns a request ID for tracking the job. |
-| status | Checks the status of a previously submitted Fal AI request and retrieves its current execution state |
-| result | Retrieves the result of a completed Fal AI request, waiting for completion if the request is still running. |
-| cancel | Asynchronously cancels a running or queued Fal AI request. |
-| upload_file | Uploads a local file to the Fal CDN and returns its public URL |
-| generate_image | Asynchronously generates images using the 'fal-ai/flux/dev' application with customizable parameters and default settings |
-
-
-## Usage
-
-- Login to AgentR
-- Follow the quickstart guide to setup MCP Server for your client
-- Visit Apps Store and enable the Falai app
-- Restart the MCP Server
-
-### Local Development
-
-- Follow the README to test with the local MCP Server

universal_mcp/applications/falai/app.py

@@ -1,332 +0,0 @@
-from pathlib import Path
-from typing import Any, Literal
-
-from fal_client import AsyncClient, AsyncRequestHandle, Status
-from loguru import logger
-
-from universal_mcp.applications import APIApplication
-from universal_mcp.exceptions import NotAuthorizedError, ToolError
-from universal_mcp.integrations import Integration
-
-Priority = Literal["normal", "low"]
-
-
-class FalaiApp(APIApplication):
-    """
-    Application for interacting with the Fal AI platform.
-
-    Provides tools to run, submit, check status, retrieve results, cancel jobs,
-    upload files to the Fal CDN, and a specialized tool for generating images.
-
-    Authentication is handled by the configured Integration provided by the
-    Universal MCP server, fetching the necessary API key.
-    """
-
-    def __init__(self, integration: Integration, **kwargs) -> None:
-        super().__init__(name="falai", integration=integration, **kwargs)
-        self._fal_client = None
-
-    @property
-    def fal_client(self) -> AsyncClient:
-        if self._fal_client is None:
-            credentials = self.integration.get_credentials()
-            logger.info(f"Credentials: {credentials}")
-            api_key = (
-            credentials.get("api_key")
-                or credentials.get("API_KEY")
-                or credentials.get("apiKey")
-            )
-            if not api_key:
-                logger.error(
-                    f"Integration {type(self.integration).__name__} returned credentials in unexpected format."
-                )
-                raise NotAuthorizedError(
-                    "Integration returned empty or invalid API key."
-                )
-            self._fal_client = AsyncClient(key=api_key)
-        return self._fal_client
-
-    async def run(
-        self,
-        arguments: Any,
-        application: str = "fal-ai/flux/dev",
-        path: str = "",
-        timeout: float | None = None,
-        hint: str | None = None,
-    ) -> Any:
-        """
-        Run a Fal AI application directly and wait for the result. Suitable for short-running applications with synchronous execution from the caller's perspective.
-
-        Args:
-            arguments: A dictionary of arguments for the application
-            application: The name or ID of the Fal application (defaults to 'fal-ai/flux/dev')
-            path: Optional subpath for the application endpoint
-            timeout: Optional timeout in seconds for the request
-            hint: Optional hint for runner selection
-
-        Returns:
-            The result of the application execution as a Python object (converted from JSON response)
-
-        Raises:
-            ToolError: Raised when the Fal API request fails, wrapping the original exception
-
-        Tags:
-            run, execute, ai, synchronous, fal, important
-        """
-        try:
-            result = await self.fal_client.run(
-                application=application,
-                arguments=arguments,
-                path=path,
-                timeout=timeout,
-                hint=hint,
-            )
-            return result
-        except Exception as e:
-            logger.error(
-                f"Error running Fal application {application}: {e}", exc_info=True
-            )
-            raise ToolError(f"Failed to run Fal application {application}: {e}") from e
-
-    async def submit(
-        self,
-        arguments: Any,
-        application: str = "fal-ai/flux/dev",
-        path: str = "",
-        hint: str | None = None,
-        webhook_url: str | None = None,
-        priority: Priority | None = None,
-    ) -> str:
-        """
-        Submits a request to the Fal AI queue for asynchronous processing and returns a request ID for tracking the job.
-
-        Args:
-            arguments: A dictionary of arguments for the application
-            application: The name or ID of the Fal application, defaulting to 'fal-ai/flux/dev'
-            path: Optional subpath for the application endpoint
-            hint: Optional hint for runner selection
-            webhook_url: Optional URL to receive a webhook when the request completes
-            priority: Optional queue priority ('normal' or 'low')
-
-        Returns:
-            The request ID (str) of the submitted asynchronous job
-
-        Raises:
-            ToolError: Raised when the Fal API request fails, wrapping the original exception
-
-        Tags:
-            submit, async_job, start, ai, queue
-        """
-        try:
-            handle: AsyncRequestHandle = await self.fal_client.submit(
-                application=application,
-                arguments=arguments,
-                path=path,
-                hint=hint,
-                webhook_url=webhook_url,
-                priority=priority,
-            )
-            request_id = handle.request_id
-            return request_id
-        except Exception as e:
-            logger.error(
-                f"Error submitting Fal application {application}: {e}", exc_info=True
-            )
-            raise ToolError(
-                f"Failed to submit Fal application {application}: {e}"
-            ) from e
-
-    async def status(
-        self,
-        request_id: str,
-        application: str = "fal-ai/flux/dev",
-        with_logs: bool = False,
-    ) -> Status:
-        """
-        Checks the status of a previously submitted Fal AI request and retrieves its current execution state
-
-        Args:
-            request_id: The unique identifier of the submitted request, obtained from a previous submit operation
-            application: The name or ID of the Fal application (defaults to 'fal-ai/flux/dev')
-            with_logs: Boolean flag to include execution logs in the status response (defaults to False)
-
-        Returns:
-            A Status object containing the current state of the request (Queued, InProgress, or Completed)
-
-        Raises:
-            ToolError: Raised when the Fal API request fails or when the provided request ID is invalid
-
-        Tags:
-            status, check, async_job, monitoring, ai
-        """
-        try:
-            handle = self.fal_client.get_handle(
-                application=application, request_id=request_id
-            )
-            status = await handle.status(with_logs=with_logs)
-            return status
-        except Exception as e:
-            logger.error(
-                f"Error getting status for Fal request_id {request_id}: {e}",
-                exc_info=True,
-            )
-            raise ToolError(
-                f"Failed to get status for Fal request_id {request_id}: {e}"
-            ) from e
-
-    async def result(
-        self, request_id: str, application: str = "fal-ai/flux/dev"
-    ) -> Any:
-        """
-        Retrieves the result of a completed Fal AI request, waiting for completion if the request is still running.
-
-        Args:
-            request_id: The unique identifier of the submitted request
-            application: The name or ID of the Fal application (defaults to 'fal-ai/flux/dev')
-
-        Returns:
-            The result of the application execution, converted from JSON response to Python data structures (dict/list)
-
-        Raises:
-            ToolError: When the Fal API request fails or the request does not complete successfully
-
-        Tags:
-            result, async-job, status, wait, ai
-        """
-        try:
-            handle = self.fal_client.get_handle(
-                application=application, request_id=request_id
-            )
-            result = await handle.get()
-            return result
-        except Exception as e:
-            logger.error(
-                f"Error getting result for Fal request_id {request_id}: {e}",
-                exc_info=True,
-            )
-            raise ToolError(
-                f"Failed to get result for Fal request_id {request_id}: {e}"
-            ) from e
-
-    async def cancel(
-        self, request_id: str, application: str = "fal-ai/flux/dev"
-    ) -> None:
-        """
-        Asynchronously cancels a running or queued Fal AI request.
-
-        Args:
-            request_id: The unique identifier of the submitted Fal AI request to cancel
-            application: The name or ID of the Fal application (defaults to 'fal-ai/flux/dev')
-
-        Returns:
-            None. The function doesn't return any value.
-
-        Raises:
-            ToolError: Raised when the cancellation request fails due to API errors or if the request cannot be cancelled
-
-        Tags:
-            cancel, async_job, ai, fal, management
-        """
-        try:
-            handle = self.fal_client.get_handle(
-                application=application, request_id=request_id
-            )
-            await handle.cancel()
-            return None
-        except Exception as e:
-            logger.error(
-                f"Error cancelling Fal request_id {request_id}: {e}", exc_info=True
-            )
-            raise ToolError(f"Failed to cancel Fal request_id {request_id}: {e}") from e
-
-    async def upload_file(self, path: str) -> str:
-        """
-        Uploads a local file to the Fal CDN and returns its public URL
-
-        Args:
-            path: The absolute or relative path to the local file
-
-        Returns:
-            A string containing the public URL of the uploaded file on the CDN
-
-        Raises:
-            ToolError: If the file is not found or if the upload operation fails
-
-        Tags:
-            upload, file, cdn, storage, async, important
-        """
-        try:
-            file_url = await self.fal_client.upload_file(Path(path))
-            return file_url
-        except FileNotFoundError as e:
-            logger.error(f"File not found for upload: {path}", exc_info=True)
-            raise ToolError(f"File not found: {path}") from e
-        except Exception as e:
-            logger.error(f"Error uploading file {path} to Fal CDN: {e}", exc_info=True)
-            raise ToolError(f"Failed to upload file {path}: {e}") from e
-
-    async def generate_image(
-        self,
-        prompt: str,
-        seed: int | None = 6252023,
-        image_size: str | None = "landscape_4_3",
-        num_images: int | None = 1,
-        extra_arguments: dict[str, Any] | None = None,
-        path: str = "",
-        timeout: float | None = None,
-        hint: str | None = None,
-    ) -> Any:
-        """
-        Asynchronously generates images using the 'fal-ai/flux/dev' application with customizable parameters and default settings
-
-        Args:
-            prompt: The text prompt used to guide the image generation
-            seed: Random seed for reproducible image generation (default: 6252023)
-            image_size: Dimensions of the generated image (default: 'landscape_4_3')
-            num_images: Number of images to generate in one request (default: 1)
-            extra_arguments: Additional arguments dictionary to pass to the application, can override defaults
-            path: Subpath for the application endpoint (rarely used)
-            timeout: Maximum time in seconds to wait for the request to complete
-            hint: Hint string for runner selection
-
-        Returns:
-            A dictionary containing the generated image URLs and related metadata
-
-        Raises:
-            ToolError: When the image generation request fails or encounters an error
-
-        Tags:
-            generate, image, ai, async, important, flux, customizable, default
-        """
-        application = "fal-ai/flux/dev"
-        arguments = {
-            "prompt": prompt,
-            "seed": seed,
-            "image_size": image_size,
-            "num_images": num_images,
-        }
-        if extra_arguments:
-            arguments.update(extra_arguments)
-            logger.debug(f"Merged extra_arguments. Final arguments: {arguments}")
-        try:
-            result = await self.run(
-                application=application,
-                arguments=arguments,
-                path=path,
-                timeout=timeout,
-                hint=hint,
-            )
-            return result
-        except Exception:
-            raise
-
-    def list_tools(self) -> list[callable]:
-        return [
-            self.run,
-            self.submit,
-            self.status,
-            self.result,
-            self.cancel,
-            self.upload_file,
-            self.generate_image,
-        ]

universal_mcp/applications/figma/README.md

@@ -1,74 +0,0 @@
-
-# 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