universal-mcp 0.1.7rc2__py3-none-any.whl → 0.1.8__py3-none-any.whl

universal_mcp/__init__.py

@@ -1,2 +0,0 @@
-def hello() -> str:
-    return "Hello from universal-mcp!"

universal_mcp/analytics.py

@@ -0,0 +1,75 @@
+import os
+import uuid
+from functools import lru_cache
+from importlib.metadata import version
+
+import posthog
+from loguru import logger
+
+
+class Analytics:
+    _instance = None
+
+    def __new__(cls):
+        if cls._instance is None:
+            cls._instance = super().__new__(cls)
+            cls._instance._initialize()
+        return cls._instance
+
+    def _initialize(self):
+        """Initialize the Analytics singleton"""
+        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():
+        """
+        Get the version of the Universal MCP
+        """
+        try:
+            return version("universal_mcp")
+        except ImportError:
+            return "unknown"
+
+    def track_app_loaded(self, app_name: str):
+        """Track when the app is 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, status: str, error: str = None, user_id=None
+    ):
+        """Track when a tool is called
+
+        Args:
+            tool_name: Name of the tool being called
+            status: Status of the tool call (success/error)
+            error: Error message if status is error
+            user_id: Optional user ID to track
+        """
+        if not self.enabled:
+            return
+        try:
+            properties = {
+                "tool_name": tool_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()

universal_mcp/applications/ahrefs/README.md

@@ -0,0 +1,76 @@
+
+# Ahrefs MCP Server
+
+An MCP Server for the Ahrefs API.
+
+## Supported Integrations
+
+- AgentR
+- API Key (Coming Soon)
+- OAuth (Coming Soon)
+
+## Tools
+
+This is automatically generated from OpenAPI schema for the Ahrefs API.
+
+## Supported Integrations
+
+This tool can be integrated with any service that supports HTTP requests.
+
+## Tool List
+
+| Tool | Description |
+|------|-------------|
+| crawler_ips | Retrieve the list of public crawler IP addresses from the API. |
+| crawler_ip_ranges | Fetches the current public crawler IP ranges from the API, optionally specifying output format. |
+| limits_and_usage | Retrieves current API subscription limits and usage statistics from the service. |
+| batch_analysis | Submits a batch analysis request with specified parameters and returns the analysis results as a dictionary. |
+| serp_overview | Retrieves a SERP (Search Engine Results Page) overview report based on specified selection, country, and keyword criteria. |
+| overview | Retrieves rank tracking overview data for a specified project, date, and device. |
+| competitors_overview | Retrieves an overview of competitor rankings for a specified project and criteria. |
+| projects | Retrieves a list of site audit projects from the configured base URL, optionally specifying an output format. |
+| domain_rating | Fetches the domain rating and related metrics for a specified target and date. |
+| backlinks_stats | Retrieves backlink statistics for a specified target and date, with optional filters for protocol, mode, and output format. |
+| outlinks_stats | Retrieves outbound link statistics for the specified target from the site explorer API. |
+| metrics | Retrieves metrics data from the site explorer API endpoint. |
+| refdomains_history | Retrieves the historical data of reference domains from a specified site. |
+| domain_rating_history | Retrieves historical domain rating data for a specified target within a given date range. |
+| url_rating_history | Retrieves URL rating history data for a specified target within a date range. |
+| pages_history | Retrieves historical page data for a target using specified filters. |
+| metrics_history | Retrieves historical metrics based on specified parameters. |
+| keywords_history | Fetches the historical keyword rankings and performance data for a specified target within an optional date range and set of filters. |
+| metrics_by_country | Fetches site metrics grouped by country for a specified target and date. |
+| pages_by_traffic | Retrieves a list of top pages for a specified target domain or URL, ranked by estimated organic search traffic. |
+| all_backlinks | Retrieves all backlinks information for a specified target using various query parameters. |
+| broken_backlinks | Fetches broken backlink data for the specified target from the site explorer API endpoint. |
+| refdomains | Retrieves referring domains data for a specified target using the Site Explorer API endpoint. |
+| anchors | Fetches anchor text distribution data for a specified target using given query parameters. |
+| linkeddomains | Retrieves linked domains for a specified target using the site explorer API endpoint. |
+| linked_anchors_external | Fetch linked external anchor data for a specified target using provided selection and filtering criteria. |
+| linked_anchors_internal | Fetches internal linked anchor data for a specified target from the site explorer API, applying optional filtering and query parameters. |
+| organic_keywords | Retrieve organic keyword data for a specified target and date from the Site Explorer API endpoint. |
+| organic_competitors | Retrieves organic competitors data for a specified target using the Site Explorer API. |
+| top_pages | Retrieves top pages data for a specified target and date from the site explorer API with customizable query parameters. |
+| paid_pages | Fetches paid pages data from the Site Explorer API based on specified filters. |
+| best_by_external_links | Fetches data about the best-performing pages of a target site based on external links, with various filtering and output options. |
+| best_by_internal_links | Retrieves the best-performing internal links for a specified target using the site explorer API endpoint. |
+| total_search_volume_history | Fetches the total historical search volume data for a specified target within a given date range and optional filters. |
+| keyword_explorer_overview | Retrieves an overview of keyword metrics and data from the keywords explorer API endpoint based on the specified filters and parameters. |
+| volume_history | Fetches the historical search volume for a given keyword in a specified country. |
+| volume_by_country | Retrieves search volume by country for a given keyword. |
+| matching_terms | Retrieves matching keyword terms from the keywords explorer API based on specified filters and search parameters. |
+| related_terms | Retrieves related keyword terms for a given selection and country, with optional filtering and pagination. |
+| search_suggestions | Fetches keyword search suggestions from the keywords explorer API based on the provided filtering and query parameters. |
+
+
+
+## Usage
+
+- Login to AgentR
+- Follow the quickstart guide to setup MCP Server for your client
+- Visit Apps Store and enable the Ahrefs app
+- Restart the MCP Server
+
+### Local Development
+
+- Follow the README to test with the local MCP Server