universal-mcp-applications 0.1.27rc2__tar.gz → 0.1.28__tar.gz

{universal_mcp_applications-0.1.27rc2 → universal_mcp_applications-0.1.28}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: universal-mcp-applications
-Version: 0.1.27rc2
+Version: 0.1.28
 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

{universal_mcp_applications-0.1.27rc2 → universal_mcp_applications-0.1.28}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "universal-mcp-applications"
-version = "0.1.27-rc2"
+version = "0.1.28"
 description = "A Universal MCP Application: universal_mcp_applications"
 readme = "README.md"
 requires-python = ">=3.11"

{universal_mcp_applications-0.1.27rc2 → universal_mcp_applications-0.1.28}/src/scripts/run_docgen.py

@@ -2,7 +2,7 @@ import os
 import subprocess
 
 APPS = [
-    "onedrive"
+    "scraper",
 ]
 
 

{universal_mcp_applications-0.1.27rc2 → universal_mcp_applications-0.1.28}/src/tests/test_applications.py

@@ -70,10 +70,10 @@ ALL_APPS = [
     "sendgrid",
     "sentry",
     "serpapi",
-    "sharepoint",  # not seeded
+    "sharepoint",
     "shopify",
     "shortcut",
-    "slack",  # not seeded
+    "slack",
     "spotify",  # not seeded
     "supabase",
     "tavily",

{universal_mcp_applications-0.1.27rc2 → universal_mcp_applications-0.1.28}/src/universal_mcp/applications/google_gemini/app.py

@@ -62,9 +62,9 @@ class GoogleGeminiApp(APIApplication):
     async def generate_image(
         self,
         prompt: Annotated[str, "The prompt to generate image from"],
-        images: Annotated[list[str], "The reference images path"] | None = None,
+        images: Annotated[list[str], "The reference image URLs"] | None = None, 
         model: str = "gemini-2.5-flash-image-preview",
-    ) -> list:
+    ) -> dict:
         """
         Generates an image based on a text prompt and an optional reference image using the Google Gemini model.
         This tool is ideal for creating visual content or modifying existing images based on natural language descriptions.
@@ -72,7 +72,7 @@ class GoogleGeminiApp(APIApplication):
 
         Args:
             prompt (str): The descriptive text prompt to guide the image generation. For example: "A futuristic city at sunset with flying cars."
-            images (list[str], optional): An optional list of URL to a reference image. These images will be used as a basis for the generation.
+            images (list[str], optional): An optional list of URLs to reference images. These images will be used as a basis for the generation.
             model (str, optional): The Gemini model to use for image generation. Defaults to "gemini-2.5-flash-image-preview".
 
         Returns:

{universal_mcp_applications-0.1.27rc2 → universal_mcp_applications-0.1.28}/src/universal_mcp/applications/onedrive/README.md

@@ -1,10 +1,10 @@
-# OneDriveApp MCP Server
+# OnedriveApp MCP Server
 
-An MCP Server for the OneDriveApp API.
+An MCP Server for the OnedriveApp API.
 
 ## 🛠️ Tool List
 
-This is automatically generated from OpenAPI schema for the OneDriveApp API.
+This is automatically generated from OpenAPI schema for the OnedriveApp API.
 
 
 | Tool | Description |
@@ -21,4 +21,4 @@ This is automatically generated from OpenAPI schema for the OneDriveApp API.
 | `list_files` | Retrieves a list of files within a specified OneDrive folder, defaulting to the root. Unlike `_list_drive_items` which fetches all items, this function filters the results to exclusively return items identified as files, excluding any subdirectories. |
 | `create_folder_and_list` | Performs a composite action: creates a new folder, then lists all items (files and folders) within that parent directory. This confirms creation by returning the parent's updated contents, distinct from `create_folder` which only returns the new folder's metadata. |
 | `upload_text_file` | Creates and uploads a new file to OneDrive directly from a string of text content. Unlike `upload_file`, which requires a local file path, this function is specifically for creating a text file from in-memory string data, with a customizable name and destination folder. |
-| `get_document_content` | Retrieves the content of a file specified by its ID. It automatically detects if the file is text or binary; text content is returned as a string, while binary content is returned base64-encoded. This differs from `download_file`, which only provides a URL. |
+| `get_document_content` | Retrieves the content of a specific file by its item ID and returns it directly as base64-encoded data. This function is distinct from `download_file`, which only provides a temporary URL for the content, and from `get_item_metadata`, which returns file attributes without the content itself. The function fetches the content by following the file's pre-authenticated download URL. |

{universal_mcp_applications-0.1.27rc2 → universal_mcp_applications-0.1.28}/src/universal_mcp/applications/onedrive/app.py

@@ -2,6 +2,7 @@ import base64
 import os
 from typing import Any
 
+from loguru import logger
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 
@@ -271,13 +272,17 @@ class OnedriveApp(APIApplication):
 
     def get_document_content(self, item_id: str) -> dict[str, Any]:
         """
-        Retrieves the content of a file specified by its ID. It automatically detects if the file is text or binary; text content is returned as a string, while binary content is returned base64-encoded. This differs from `download_file`, which only provides a URL.
+        Retrieves the content of a specific file by its item ID and returns it directly as base64-encoded data. This function is distinct from `download_file`, which only provides a temporary URL for the content, and from `get_item_metadata`, which returns file attributes without the content itself. The function fetches the content by following the file's pre-authenticated download URL.
 
         Args:
             item_id (str): The ID of the file.
 
         Returns:
-            A dictionary containing the file content. For text files, content is string. For binary, it's base64 encoded.
+            dict[str, Any]: A dictionary containing the file details:
+                - 'type' (str): The general type of the file (e.g., "image", "audio", "video", "file").
+                - 'data' (str): The base64 encoded content of the file.
+                - 'mime_type' (str): The MIME type of the file.
+                - 'file_name' (str): The name of the file.
 
         Tags:
             get, content, read, file, important
@@ -290,34 +295,29 @@ class OnedriveApp(APIApplication):
         if not file_metadata:
             raise ValueError(f"Item with ID '{item_id}' is not a file.")
 
-        file_mime_type = file_metadata.get("mimeType", "")
+        file_mime_type = file_metadata.get("mimeType", "application/octet-stream")
+        file_name = metadata.get("name")
 
-        url = f"{self.base_url}/me/drive/items/{item_id}/content"
-        response = self._get(url)
-
-        if response.status_code >= 400:
-            # Try to handle as JSON error response from Graph API
-            return self._handle_response(response)
+        download_url = metadata.get("@microsoft.graph.downloadUrl")
+        if not download_url:
+            logger.error(f"Could not find @microsoft.graph.downloadUrl in metadata for item {item_id}")
+            raise ValueError("Could not retrieve download URL for the item.")
 
-        content = response.content
+        response = self._get(download_url)
 
-        is_text = file_mime_type.startswith("text/") or any(t in file_mime_type for t in ["json", "xml", "csv", "javascript", "html"])
+        response.raise_for_status()
 
-        content_dict = {}
-        if is_text:
-            try:
-                content_dict["content"] = content.decode("utf-8")
-            except UnicodeDecodeError:
-                is_text = False
+        content = response.content
 
-        if not is_text:
-            content_dict["content_base64"] = base64.b64encode(content).decode("ascii")
+        attachment_type = file_mime_type.split("/")[0] if "/" in file_mime_type else "file"
+        if attachment_type not in ["image", "audio", "video", "text"]:
+            attachment_type = "file"
 
         return {
-            "name": metadata.get("name"),
-            "content_type": "text" if is_text else "binary",
-            **content_dict,
-            "size": len(content),
+            "type": attachment_type,
+            "data": content,
+            "mime_type": file_mime_type,
+            "file_name": file_name,
         }
 
     def list_tools(self):

universal_mcp_applications-0.1.28/src/universal_mcp/applications/scraper/app.py

@@ -0,0 +1,175 @@
+from dotenv import load_dotenv
+
+load_dotenv()
+
+from typing import Any, Literal
+
+from loguru import logger
+from universal_mcp.applications.application import APIApplication
+from universal_mcp.integrations import Integration
+
+from universal_mcp.applications.unipile import UnipileApp
+
+
+class ScraperApp(APIApplication):
+    """
+    Application for interacting with LinkedIn API.
+    Provides a simplified interface for LinkedIn search operations.
+    """
+
+    def __init__(self, integration: Integration, **kwargs: Any) -> None:
+        super().__init__(name="scraper", integration=integration, **kwargs)
+        if self.integration:
+            credentials = self.integration.get_credentials()
+            self.account_id = credentials.get("account_id")
+            self._unipile_app = UnipileApp(integration=self.integration)
+        else:
+            logger.warning("Integration not found")
+            self.account_id = None
+            self._unipile_app = None
+
+    def linkedin_search(
+        self,
+        category: Literal["people", "companies", "posts", "jobs"],
+        cursor: str | None = None,
+        limit: int | None = None,
+        keywords: str | None = None,
+        date_posted: str | None = None,
+        sort_by: str | None = None,
+        minimum_salary_value: int | None = None,
+    ) -> dict[str, Any]:
+        """
+        Performs a general LinkedIn search for posts, people, companies, or jobs using keywords and various filters. This function provides broad, keyword-based discovery across the platform, distinct from other methods that retrieve content from a specific user or company profile. It supports pagination and filtering criteria.
+        
+        Args:
+            category: Type of search to perform - "people", "companies", "posts", or "jobs".
+            cursor: Pagination cursor for the next page of entries.
+            limit: Number of items to return (up to 50 for Classic search).
+            keywords: Keywords to search for.
+            date_posted: Filter by when the post was posted (posts only).
+            sort_by: How to sort the results (for posts and jobs).
+            minimum_salary_value: The minimum salary to filter for (jobs only).
+        
+        Returns:
+            A dictionary containing search results and pagination details.
+        
+        Raises:
+            httpx.HTTPError: If the API request fails.
+        
+        Tags:
+            linkedin, search, posts, people, companies, api, scrapper, important
+        """
+        return self._unipile_app.search(
+            account_id=self.account_id,
+            category=category,
+            cursor=cursor,
+            limit=limit,
+            keywords=keywords,
+            date_posted=date_posted,
+            sort_by=sort_by,
+            minimum_salary_value=minimum_salary_value,
+        )
+
+    def linkedin_list_profile_posts(
+        self,
+        identifier: str,
+        cursor: str | None = None,
+        limit: int | None = None,
+    ) -> dict[str, Any]:
+        """
+        Fetches a paginated list of all posts from a specific user or company profile using their unique identifier. This function retrieves content directly from a single profile, unlike the broader, keyword-based `linkedin_search` which searches across the entire LinkedIn platform.
+        
+        Args:
+            identifier: The entity's provider internal ID (LinkedIn ID).starts with ACo for users, while for companies it's a series of numbers. You can get it in the results of linkedin_search.
+            cursor: Pagination cursor for the next page of entries.
+            limit: Number of items to return (1-100, though spec allows up to 250).
+        
+        Returns:
+            A dictionary containing a list of post objects and pagination details.
+        
+        Raises:
+            httpx.HTTPError: If the API request fails.
+        
+        Tags:
+            linkedin, post, list, user_posts, company_posts, content, api, important
+        """
+
+        return self._unipile_app.list_profile_posts(
+            identifier=identifier,
+            account_id=self.account_id,
+            cursor=cursor,
+            limit=limit,
+        )
+
+    def linkedin_retrieve_profile(
+        self,
+        identifier: str,
+    ) -> dict[str, Any]:
+        """
+        Retrieves a specific LinkedIn user's profile using their unique identifier (e.g., public username). Unlike other methods that list posts or comments, this function focuses on fetching the user's core profile data by delegating the request to the integrated Unipile application.
+        
+        Args:
+            identifier: Use the id from linkedin_search results. It starts with ACo for users and is a series of numbers for companies.
+        
+        Returns:
+            A dictionary containing the user's profile details.
+        
+        Raises:
+            httpx.HTTPError: If the API request fails.
+        
+        Tags:
+            linkedin, user, profile, retrieve, get, api, important
+        """
+
+        return self._unipile_app.retrieve_user_profile(
+            identifier=identifier,
+            account_id=self.account_id,
+        )
+
+    def linkedin_list_post_comments(
+        self,
+        post_id: str,
+        comment_id: str | None = None,
+        cursor: str | None = None,
+        limit: int | None = None,
+    ) -> dict[str, Any]:
+        """
+        Fetches a paginated list of comments for a specified LinkedIn post. Providing a `comment_id` retrieves replies to that specific comment instead of top-level ones. This function exclusively targets post interactions, differentiating it from others that list posts or retrieve entire profiles.
+        
+        Args:
+            post_id: The social ID of the post. Example urn:li:ugcPost:7386500271624896512
+            comment_id: If provided, retrieves replies to this comment ID instead of top-level comments.
+            cursor: Pagination cursor.
+            limit: Number of comments to return.
+        
+        Returns:
+            A dictionary containing a list of comment objects and pagination details.
+        
+        Raises:
+            httpx.HTTPError: If the API request fails.
+        
+        Tags:
+            linkedin, post, comment, list, content, api, important
+        """
+
+        return self._unipile_app.list_post_comments(
+            post_id=post_id,
+            account_id=self.account_id,
+            comment_id=comment_id,
+            cursor=cursor,
+            limit=limit,
+        )
+
+    def list_tools(self):
+        """
+        Returns a list of available tools/functions in this application.
+
+        Returns:
+            A list of functions that can be used as tools.
+        """
+        return [
+            self.linkedin_search,
+            self.linkedin_list_profile_posts,
+            self.linkedin_retrieve_profile,
+            self.linkedin_list_post_comments,
+        ]

universal_mcp_applications-0.1.28/src/universal_mcp/applications/sharepoint/README.md

@@ -0,0 +1,19 @@
+# SharePoint Application
+
+This application provides tools for interacting with the Microsoft SharePoint API via Microsoft Graph. It allows you to manage files, folders, and retrieve information about your SharePoint drive.
+
+## Available Tools
+
+-   `get_my_profile`: Fetches the profile for the currently authenticated user.
+-   `get_drive_info`: Fetches high-level information about the user's SharePoint drive.
+-   `search_files`: Searches for files and folders in the user's SharePoint.
+-   `get_item_metadata`: Fetches metadata for a specific file or folder.
+-   `create_folder`: Creates a new folder.
+-   `delete_item`: Deletes a file or folder.
+-   `download_file`: Retrieves a download URL for a file.
+-   `upload_file`: Uploads a local file.
+-   `list_folders`: Lists all folders in a specified directory.
+-   `list_files`: Lists all files in a specified directory.
+-   `create_folder_and_list`: Creates a folder and then lists the contents of the parent directory.
+-   `upload_text_file`: Uploads content from a string to a new text file.
+-   `get_document_content`: Retrieves the content of a file.