universal-mcp 0.1.11rc3__py3-none-any.whl → 0.1.13__py3-none-any.whl

universal_mcp/utils/readme.py

@@ -0,0 +1,92 @@
+import importlib
+from pathlib import Path
+
+from jinja2 import Environment, FileSystemLoader, TemplateError, select_autoescape
+from loguru import logger
+
+
+def _import_class(module_path: str, class_name: str):
+    """
+    Helper to import a class by name from a module.
+    Raises ModuleNotFoundError if module or class does not exist.
+    """
+    try:
+        spec = importlib.util.spec_from_file_location("temp_module", module_path)
+        module = importlib.util.module_from_spec(spec)
+        spec.loader.exec_module(module)
+    except ModuleNotFoundError as e:
+        logger.debug(f"Import failed for module '{module_path}': {e}")
+        raise
+    try:
+        return getattr(module, class_name)
+    except AttributeError as e:
+        logger.error(f"Class '{class_name}' not found in module '{module_path}'")
+        raise ModuleNotFoundError(
+            f"Class '{class_name}' not found in module '{module_path}'"
+        ) from e
+
+
+def generate_readme(app: Path, class_name: str) -> Path:
+    """Generate README.md with API documentation.
+
+    Args:
+        app_dir: Directory where the README will be generated
+        folder_name: Name of the application folder
+        tools: List of Function objects from the OpenAPI schema
+
+    Returns:
+        Path to the generated README file
+
+    Raises:
+        FileNotFoundError: If the template directory doesn't exist
+        TemplateError: If there's an error rendering the template
+        IOError: If there's an error writing the README file
+    """
+
+    # Import the app
+    app_instance = _import_class(app, class_name)(integration=None)
+    # List tools by calling list_tools()
+    tools = app_instance.list_tools()
+    # Format tools into (name, description) tuples
+    formatted_tools = []
+    for tool in tools:
+        name = tool.__name__
+        description = tool.__doc__.strip().split("\n")[0]
+        formatted_tools.append((name, description))
+    # Render the template
+    # Set up Jinja2 environment
+    template_dir = Path(__file__).parent.parent / "templates"
+    if not template_dir.exists():
+        logger.error(f"Template directory not found: {template_dir}")
+        raise FileNotFoundError(f"Template directory not found: {template_dir}")
+
+    try:
+        env = Environment(
+            loader=FileSystemLoader(template_dir), autoescape=select_autoescape()
+        )
+        template = env.get_template("README.md.j2")
+    except Exception as e:
+        logger.error(f"Error loading template: {e}")
+        raise TemplateError(f"Error loading template: {e}") from e
+    # Write the README file
+    try:
+        readme_content = template.render(name=class_name, tools=formatted_tools)
+    except Exception as e:
+        logger.error(f"Error rendering template: {e}")
+        raise TemplateError(f"Error rendering template: {e}") from e
+
+    # Write the README file
+    app_dir = app.parent
+    readme_file = app_dir / "README.md"
+
+    # Write the README file
+    readme_file = app_dir / "README.md"
+    try:
+        with open(readme_file, "w") as f:
+            f.write(readme_content)
+        logger.info(f"Documentation generated at: {readme_file}")
+    except Exception as e:
+        logger.error(f"Error writing README file: {e}")
+        raise OSError(f"Error writing README file: {e}") from e
+
+    return readme_file

universal_mcp/utils/singleton.py

@@ -0,0 +1,23 @@
+class Singleton(type):
+    """Metaclass that ensures only one instance of a class exists.
+
+    This metaclass implements the singleton pattern by maintaining a dictionary
+    of instances for each class that uses it. When a class with this metaclass
+    is instantiated, it checks if an instance already exists and returns that
+    instance instead of creating a new one.
+
+    Example:
+        class MyClass(metaclass=Singleton):
+            pass
+
+        a = MyClass()
+        b = MyClass()
+        assert a is b  # True
+    """
+
+    _instances = {}
+
+    def __call__(cls, *args, **kwargs):
+        if cls not in cls._instances:
+            cls._instances[cls] = super().__call__(*args, **kwargs)
+        return cls._instances[cls]

{universal_mcp-0.1.11rc3.dist-info → universal_mcp-0.1.13.dist-info}/METADATA

@@ -1,13 +1,14 @@
 Metadata-Version: 2.4
 Name: universal-mcp
-Version: 0.1.11rc3
+Version: 0.1.13
 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
 Requires-Python: >=3.11
+Requires-Dist: cookiecutter>=2.6.0
 Requires-Dist: gql[all]>=3.5.2
+Requires-Dist: jinja2>=3.1.3
 Requires-Dist: keyring>=25.6.0
-Requires-Dist: langchain-cerebras>=0.5.0
-Requires-Dist: langchain-google-genai>=2.1.3
 Requires-Dist: litellm>=1.30.7
 Requires-Dist: loguru>=0.7.3
 Requires-Dist: mcp>=1.6.0
@@ -17,41 +18,14 @@ 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: all
-Requires-Dist: e2b-code-interpreter>=1.2.0; extra == 'all'
-Requires-Dist: fal-client>=0.5.9; extra == 'all'
-Requires-Dist: fastapi[standard]>=0.115.12; extra == 'all'
-Requires-Dist: firecrawl-py>=1.15.0; extra == 'all'
-Requires-Dist: google-search-results>=2.4.2; extra == 'all'
-Requires-Dist: langchain-mcp-adapters>=0.0.3; extra == 'all'
-Requires-Dist: langchain-openai>=0.3.12; extra == 'all'
-Requires-Dist: langgraph-checkpoint-sqlite>=2.0.6; extra == 'all'
-Requires-Dist: langgraph>=0.3.24; extra == 'all'
-Requires-Dist: litellm>=1.30.7; extra == 'all'
-Requires-Dist: markitdown[all]>=0.1.1; extra == 'all'
-Requires-Dist: pyright>=1.1.398; extra == 'all'
-Requires-Dist: pytest-asyncio>=0.26.0; extra == 'all'
-Requires-Dist: pytest>=8.3.5; extra == 'all'
-Requires-Dist: python-dotenv>=1.0.1; extra == 'all'
-Requires-Dist: ruff>=0.11.4; extra == 'all'
-Requires-Dist: streamlit>=1.44.1; extra == 'all'
-Requires-Dist: watchdog>=6.0.0; extra == 'all'
 Provides-Extra: dev
 Requires-Dist: litellm>=1.30.7; 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'
-Provides-Extra: e2b
-Requires-Dist: e2b-code-interpreter>=1.2.0; extra == 'e2b'
-Provides-Extra: fal-ai
-Requires-Dist: fal-client>=0.5.9; extra == 'fal-ai'
-Provides-Extra: firecrawl
-Requires-Dist: firecrawl-py>=1.15.0; extra == 'firecrawl'
-Provides-Extra: markitdown
-Requires-Dist: markitdown[all]>=0.1.1; extra == 'markitdown'
 Provides-Extra: playground
-Requires-Dist: fastapi[standard]>=0.115.12; extra == 'playground'
 Requires-Dist: langchain-mcp-adapters>=0.0.3; extra == 'playground'
 Requires-Dist: langchain-openai>=0.3.12; extra == 'playground'
 Requires-Dist: langgraph-checkpoint-sqlite>=2.0.6; extra == 'playground'
@@ -59,8 +33,6 @@ Requires-Dist: langgraph>=0.3.24; extra == 'playground'
 Requires-Dist: python-dotenv>=1.0.1; extra == 'playground'
 Requires-Dist: streamlit>=1.44.1; extra == 'playground'
 Requires-Dist: watchdog>=6.0.0; extra == 'playground'
-Provides-Extra: serpapi
-Requires-Dist: google-search-results>=2.4.2; extra == 'serpapi'
 Description-Content-Type: text/markdown
 
 # Universal MCP
@@ -73,6 +45,8 @@ Universal MCP acts as a middleware layer for your API applications, enabling sea
 - **Managed Authentication**: Built-in support for API keys and OAuth-based authentication flows
 - **Extensible Architecture**: Easily build and add new app integrations with minimal boilerplate
 - **Credential Management**: Flexible storage options for API credentials with memory and environment-based implementations
+- **Tool Management**: Comprehensive tool registration, validation, and execution capabilities
+- **Multiple Server Types**: Support for local, AgentR, and single-application server configurations
 
 ## 🔧 Installation
 
@@ -170,27 +144,7 @@ python src/playground
 Refer to `src/playground/README.md` for more detailed setup and usage instructions.
 
 ## 🧩 Available Applications
-
-Universal MCP comes with several pre-built applications:
-
-| Application Slug | Description                              | Authentication Type                       |
-| :--------------- | :--------------------------------------- | :---------------------------------------- |
-| `e2b`            | Execute Python code in secure sandboxes  | API Key (via Integration)                 |
-| `firecrawl`      | Scrape/crawl web pages, search           | API Key (via Integration)                 |
-| `github`         | Interact with GitHub repos, issues, PRs  | OAuth (AgentR)                            |
-| `google-calendar`| Manage Google Calendar events            | OAuth (AgentR)                            |
-| `google-docs`    | Create and manage Google Docs documents  | OAuth (AgentR)                            |
-| `google-drive`   | Manage Google Drive files and folders    | OAuth (AgentR)                            |
-| `google-mail`    | Read and send Gmail emails               | OAuth (AgentR)                            |
-| `google-sheet`   | Manage Google Sheets spreadsheets        | OAuth (AgentR)                            |
-| `markitdown`     | Convert web pages/files to Markdown      | None                                      |
-| `notion`         | Interact with Notion pages/databases     | OAuth (AgentR)                            |
-| `perplexity`     | Interact with Perplexity AI models       | API Key (via Integration)                 |
-| `reddit`         | Interact with Reddit posts/comments      | OAuth (AgentR)                            |
-| `resend`         | Send emails via Resend API               | API Key (via Integration)                 |
-| `serpapi`        | Perform web searches via SerpApi         | API Key (via Integration)                 |
-| `tavily`         | Advanced web search & research API       | API Key (via Integration)                 |
-| `zenquotes`      | Get inspirational quotes                 | None                                      |
+Visit [https://agentr.dev](https://agentr.dev) to check all available applications
 
 *Authentication Type notes:*
 *   *OAuth (AgentR)*: Typically requires configuring the integration with `type: "agentr"` in your `ServerConfig`. Requires the `AGENTR_API_KEY`.
@@ -275,6 +229,15 @@ universal_mcp --version
     -   `litellm` (optional, for `docgen` command)
     -   ... and others specific to certain applications.
 
+## 📚 Documentation
+
+For more detailed information about specific components:
+
+- [Tools Documentation](src/universal_mcp/tools/README.md) - Learn about tool management and conversion
+- [Servers Documentation](src/universal_mcp/servers/README.md) - Understand different server implementations
+- [Stores Documentation](src/universal_mcp/stores/README.md) - Explore credential storage options
+- [Integrations Documentation](src/universal_mcp/integrations/README.md) - Learn about authentication methods
+
 ## 📝 License
 
 This project is licensed under the MIT License.

universal_mcp-0.1.13.dist-info/RECORD

@@ -0,0 +1,39 @@
+universal_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+universal_mcp/analytics.py,sha256=aGCg0Okpcy06W70qCA9I8_ySOiCgAtzJAIWAdhBsOeA,2212
+universal_mcp/cli.py,sha256=aQioMc0ZpE5uL9h_qrk_eS514H0woQOsTsjEzL6Khto,8552
+universal_mcp/config.py,sha256=sJaPI4q51CDPPG0z32rMJiE7a64eaa9nxbjJgYnaFA4,838
+universal_mcp/exceptions.py,sha256=WApedvzArNujD0gZfUofYBxjQo97ZDJLqDibtLWZoRk,373
+universal_mcp/logger.py,sha256=D947u1roUf6WqlcEsPpvmWDqGc8L41qF3MO1suK5O1Q,308
+universal_mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+universal_mcp/applications/__init__.py,sha256=ZjV0P55Ej0vjIQ_bCSNatWTX-VphDJ6OGePWBu3bu3U,3196
+universal_mcp/applications/application.py,sha256=0eC9D4HHRwIGpuFusaCxTZ0u64U68VbBpRSxjxGB5y8,8152
+universal_mcp/integrations/README.md,sha256=lTAPXO2nivcBe1q7JT6PRa6v9Ns_ZersQMIdw-nmwEA,996
+universal_mcp/integrations/__init__.py,sha256=tg6Yk59AEhwPsrTp0hZQ3NBfmJuYGu2sNCOXuph-h9k,922
+universal_mcp/integrations/integration.py,sha256=genBiaWuzCs-XCf3UD1j8PQYyGU3GiVO4uupSdJRHnA,12601
+universal_mcp/servers/README.md,sha256=ytFlgp8-LO0oogMrHkMOp8SvFTwgsKgv7XhBVZGNTbM,2284
+universal_mcp/servers/__init__.py,sha256=dDtvvMzbWskABlobTZHztrWMb3hbzgidza3BmEmIAD8,474
+universal_mcp/servers/server.py,sha256=0oJQQUiwPdG2q79tzsVv3WPMV5YIFbF14PRvBF-SxMQ,9395
+universal_mcp/stores/README.md,sha256=jrPh_ow4ESH4BDGaSafilhOVaN8oQ9IFlFW-j5Z5hLA,2465
+universal_mcp/stores/__init__.py,sha256=quvuwhZnpiSLuojf0NfmBx2xpaCulv3fbKtKaSCEmuM,603
+universal_mcp/stores/store.py,sha256=lYaFd-9YKC404BPeqzNw_Xm3ziQjksZyvQtaW1yd9FM,6900
+universal_mcp/templates/README.md.j2,sha256=gNry-IrGUdumhgWyHFVxOKgXf_MR4RFK6SI6jF3Tuns,2564
+universal_mcp/templates/api_client.py.j2,sha256=972Im7LNUAq3yZTfwDcgivnb-b8u6_JLKWXwoIwXXXQ,908
+universal_mcp/tools/README.md,sha256=RuxliOFqV1ZEyeBdj3m8UKfkxAsfrxXh-b6V4ZGAk8I,2468
+universal_mcp/tools/__init__.py,sha256=hVL-elJLwD_K87Gpw_s2_o43sQRPyRNOnxlzt0_Pfn8,72
+universal_mcp/tools/adapters.py,sha256=2HvpyFiI0zg9dp0XshnG7t6KrVqFHM7hgtmgY1bsHN0,927
+universal_mcp/tools/func_metadata.py,sha256=f_5LdDNsOu1DpXvDUeZYiJswVmwGZz6IMPtpJJ5B2-Y,7975
+universal_mcp/tools/tools.py,sha256=9YzFbX0YHdz7RrVyKKBx-eyFEnYD4HPoUVtSAftgdk4,12889
+universal_mcp/utils/__init__.py,sha256=8wi4PGWu-SrFjNJ8U7fr2iFJ1ktqlDmSKj1xYd7KSDc,41
+universal_mcp/utils/agentr.py,sha256=3sobve7Odk8pIAZm3RHTX4Rc21rkBClcXQgXXslbSUA,3490
+universal_mcp/utils/api_generator.py,sha256=x3LkJm3tXgl2qVQq-ZQW86w7IqbErEdFTfwBP3aOwyI,4763
+universal_mcp/utils/docgen.py,sha256=zPmZ-b-fK6xk-dwHEx2hwShN-iquPD_O15CGuPwlj2k,21870
+universal_mcp/utils/docstring_parser.py,sha256=j7aE-LLnBOPTJI0qXayf0NlYappzxICv5E_hUPNmAlc,11459
+universal_mcp/utils/dump_app_tools.py,sha256=9bQePJ4ZKzGtcIYrBgLxbKDOZmL7ajIAHhXljT_AlyA,2041
+universal_mcp/utils/installation.py,sha256=H6woSY5AljEy_m5KgiAlHtNfe8eygOu4ZXNs5Q4H_y4,10307
+universal_mcp/utils/openapi.py,sha256=GhUdSefVOrOFMw15ZAIaEma-XKu6ptHv65ds0g7ntBo,24924
+universal_mcp/utils/readme.py,sha256=Q4E3RidWVg0ngYBGZCKcoA4eX6wlkCpvU-clU0E7Q20,3305
+universal_mcp/utils/singleton.py,sha256=kolHnbS9yd5C7z-tzaUAD16GgI-thqJXysNi3sZM4No,733
+universal_mcp-0.1.13.dist-info/METADATA,sha256=EU8Am27RHzp4o0mU_fwcGhAOHaHQduFMbLd5gfRYBak,9800
+universal_mcp-0.1.13.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+universal_mcp-0.1.13.dist-info/entry_points.txt,sha256=QlBrVKmA2jIM0q-C-3TQMNJTTWOsOFQvgedBq2rZTS8,56
+universal_mcp-0.1.13.dist-info/RECORD,,

universal_mcp/applications/ahrefs/README.md

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