universal-mcp 0.1.14__py3-none-any.whl → 0.1.15__py3-none-any.whl

universal_mcp/utils/{readme.py → openapi/readme.py}

@@ -1,3 +1,4 @@
+import ast
 import importlib
 from pathlib import Path
 
@@ -6,10 +7,6 @@ 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)
@@ -26,35 +23,33 @@ def _import_class(module_path: str, class_name: str):
         ) from e
 
 
-def generate_readme(app: Path, class_name: str) -> Path:
-    """Generate README.md with API documentation.
+def _get_single_class_name(file_path: Path) -> str:
+    with open(file_path) as file:
+        tree = ast.parse(file.read(), filename=str(file_path))
+    class_defs = [
+        node.name for node in ast.walk(tree) if isinstance(node, ast.ClassDef)
+    ]
+    if len(class_defs) == 1:
+        logger.info(f"Auto-detected class: {class_defs[0]}")
+        return class_defs[0]
+    elif len(class_defs) == 0:
+        raise ValueError(f"No class found in {file_path}")
+    else:
+        raise ValueError(f"Multiple classes found in {file_path}; please specify one.")
 
-    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
+def generate_readme(app: Path) -> Path:
+    """Generate README.md with API documentation from a file containing one class."""
+    class_name = _get_single_class_name(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}")
@@ -68,19 +63,14 @@ def generate_readme(app: Path, class_name: str) -> Path:
     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"
+    readme_file = app.parent / "README.md"
     try:
         with open(readme_file, "w") as f:
             f.write(readme_content)

universal_mcp/utils/templates/README.md.j2

@@ -0,0 +1,17 @@
+# {{ name }} MCP Server
+
+An MCP Server for the {{ name }} API.
+
+## 🛠️ Tool List
+
+This is automatically generated from OpenAPI schema for the {{ name }} API.
+
+{% if tools %}
+| Tool | Description |
+|------|-------------|
+{%- for tool_name, tool_desc in tools %}
+| `{{ tool_name }}` | {{ tool_desc }} |
+{%- endfor %}
+{% else %}
+No tools with documentation were found in this API client.
+{% endif %}

{universal_mcp-0.1.14.dist-info → universal_mcp-0.1.15.dist-info}/METADATA

@@ -1,17 +1,20 @@
 Metadata-Version: 2.4
 Name: universal-mcp
-Version: 0.1.14
+Version: 0.1.15
 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
+License-File: LICENSE
 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: jsonref>=1.1.0
 Requires-Dist: keyring>=25.6.0
+Requires-Dist: langchain-mcp-adapters>=0.0.3
 Requires-Dist: litellm>=1.30.7
 Requires-Dist: loguru>=0.7.3
-Requires-Dist: mcp>=1.6.0
+Requires-Dist: mcp>=1.7.1
 Requires-Dist: posthog>=3.24.0
 Requires-Dist: pydantic-settings>=2.8.1
 Requires-Dist: pydantic>=2.11.1
@@ -26,10 +29,10 @@ 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: 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'
 Requires-Dist: langgraph>=0.3.24; extra == 'playground'
+Requires-Dist: litellm>=1.30.7; 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'

universal_mcp-0.1.15.dist-info/RECORD

@@ -0,0 +1,44 @@
+universal_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+universal_mcp/analytics.py,sha256=Dkv8mkc_2T2t5NxLSZzcr3BlmOispj1RKtbB86V1i4M,2306
+universal_mcp/cli.py,sha256=fqB4CzcA2CAg1m4tzhK0k9X4otHWxaAy2edP1QQYUIQ,8974
+universal_mcp/config.py,sha256=xqz5VNxtk6Clepjw-aK-HrgMFQLzFuxiDb1fuHGpbxE,3717
+universal_mcp/exceptions.py,sha256=2A_aIzcwjB99tR4xCFjPkWPf10rBK_785FerJI7Tzns,564
+universal_mcp/logger.py,sha256=JtAC8ImO74lvt5xepV3W5BIz-u3nZOAY1ecdhmQhub0,2081
+universal_mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+universal_mcp/applications/README.md,sha256=eqbizxaTxKH2O1tyIJR2yI0Db5TQxtgPd_vbpWyCa2Y,3527
+universal_mcp/applications/__init__.py,sha256=zyV_0GyunGBA5OEO1FQsTOsj34SYjnERu5dDJLxd6c0,3133
+universal_mcp/applications/application.py,sha256=9PfmvVx1csmy0RzaTC71S4DkMD8VxvY3yIsMAt3dQLw,14425
+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=4SRcD78ZF9-m65aTxkoF-CZl7XKUsfSr1wppKz_ZgiA,13078
+universal_mcp/servers/README.md,sha256=ytFlgp8-LO0oogMrHkMOp8SvFTwgsKgv7XhBVZGNTbM,2284
+universal_mcp/servers/__init__.py,sha256=etFrqXFODIl9oGeqQS-aUxzw4J6pjzYjHl4VPvQaR3A,508
+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=mxnmOVlDNrr8OKhENWDtCIfK7YeCBQcGdS6I2ogRCsU,6756
+universal_mcp/tools/README.md,sha256=RuxliOFqV1ZEyeBdj3m8UKfkxAsfrxXh-b6V4ZGAk8I,2468
+universal_mcp/tools/__init__.py,sha256=Fatza_R0qYWmNF1WQSfUZZKQFu5qf-16JhZzdmyx3KY,333
+universal_mcp/tools/adapters.py,sha256=gz_sNDc_bseMHWmpQmqhOq65veE-DuK_kJYXGIx0Wi8,1427
+universal_mcp/tools/func_metadata.py,sha256=4LrOeQ81RnfWjPp9N-tOkw-nr6XosRw6P0EUriNhpu4,8328
+universal_mcp/tools/manager.py,sha256=OArAbckBay5Lbpu2-oI38zEEbJyM8E_WLB8985B6a70,7718
+universal_mcp/tools/tools.py,sha256=lg1rM9644OLAmi-yXar-olPCAfsu1ol2Aw9XRuIN7Fk,3383
+universal_mcp/utils/__init__.py,sha256=8wi4PGWu-SrFjNJ8U7fr2iFJ1ktqlDmSKj1xYd7KSDc,41
+universal_mcp/utils/agentr.py,sha256=3sobve7Odk8pIAZm3RHTX4Rc21rkBClcXQgXXslbSUA,3490
+universal_mcp/utils/common.py,sha256=F2Teso1Cs4E1dgMq0ESLJOWJ0n9arLX-YuawfYfZg3I,911
+universal_mcp/utils/docstring_parser.py,sha256=j7aE-LLnBOPTJI0qXayf0NlYappzxICv5E_hUPNmAlc,11459
+universal_mcp/utils/installation.py,sha256=1n5X_aIiuY8WNQn6Oji_gZ-aiRmNXxrg-qYRv-pGjxw,10195
+universal_mcp/utils/singleton.py,sha256=kolHnbS9yd5C7z-tzaUAD16GgI-thqJXysNi3sZM4No,733
+universal_mcp/utils/openapi/__inti__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+universal_mcp/utils/openapi/api_generator.py,sha256=aNzrcglYXL6mQizFQUuiFFKTPuEPgTC1unr6NT_U0VM,4771
+universal_mcp/utils/openapi/docgen.py,sha256=zPmZ-b-fK6xk-dwHEx2hwShN-iquPD_O15CGuPwlj2k,21870
+universal_mcp/utils/openapi/openapi.py,sha256=PeCj01skdvBaYvGedSShgUrzZ2GhEpPX8IOyTvq-ubk,37284
+universal_mcp/utils/openapi/preprocessor.py,sha256=zMCsHv9lNIrIlAMyF39cIm0-c2vydrtbtQjJ0rjcLL8,48765
+universal_mcp/utils/openapi/readme.py,sha256=wTg2D0sPKppPmGn7b-vtD5hAGRv8DLEAuxMNzqBeuEs,3032
+universal_mcp/utils/templates/README.md.j2,sha256=Mrm181YX-o_-WEfKs01Bi2RJy43rBiq2j6fTtbWgbTA,401
+universal_mcp/utils/templates/api_client.py.j2,sha256=972Im7LNUAq3yZTfwDcgivnb-b8u6_JLKWXwoIwXXXQ,908
+universal_mcp-0.1.15.dist-info/METADATA,sha256=iHo5gK5ZOO1OoNOYLAalp3X1qnH3JBsEpkp9YqXBiKM,9883
+universal_mcp-0.1.15.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+universal_mcp-0.1.15.dist-info/entry_points.txt,sha256=QlBrVKmA2jIM0q-C-3TQMNJTTWOsOFQvgedBq2rZTS8,56
+universal_mcp-0.1.15.dist-info/licenses/LICENSE,sha256=NweDZVPslBAZFzlgByF158b85GR0f5_tLQgq1NS48To,1063
+universal_mcp-0.1.15.dist-info/RECORD,,

universal_mcp-0.1.15.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Agentr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

universal_mcp/templates/README.md.j2

@@ -1,93 +0,0 @@
-# {{ name }} MCP Server
-
-An MCP Server for the {{ name }} API.
-
-## 📋 Prerequisites
-
-Before you begin, ensure you have met the following requirements:
-* Python 3.11+ (Recommended)
-* [uv](https://github.com/astral-sh/uv) installed globally (`pip install uv`)
-
-## 🛠️ Setup Instructions
-
-Follow these steps to get the development environment up and running:
-
-### 1. Sync Project Dependencies
-Navigate to the project root directory (where `pyproject.toml` is located).
-```bash
-uv sync
-```
-This command uses `uv` to install all dependencies listed in `pyproject.toml` into a virtual environment (`.venv`) located in the project root.
-
-### 2. Activate the Virtual Environment
-Activating the virtual environment ensures that you are using the project's specific dependencies and Python interpreter.
-- On **Linux/macOS**:
-```bash
-source .venv/bin/activate
-```
-- On **Windows**:
-```bash
-.venv\\Scripts\\activate
-```
-
-### 3. Start the MCP Inspector
-Use the MCP CLI to start the application in development mode.
-```bash
-mcp dev src/{{ name.lower() }}/mcp.py
-```
-The MCP inspector should now be running. Check the console output for the exact address and port.
-
-## 🔌 Supported Integrations
-
-- AgentR
-- API Key (Coming Soon)
-- OAuth (Coming Soon)
-
-## 🛠️ Tool List
-
-This is automatically generated from OpenAPI schema for the {{ name }} API.
-
-{% if tools %}
-| Tool | Description |
-|------|-------------|
-{%- for tool_name, tool_desc in tools %}
-| `{{ tool_name }}` | {{ tool_desc }} |
-{%- endfor %}
-{% else %}
-No tools with documentation were found in this API client.
-{% endif %}
-
-## 📁 Project Structure
-
-The generated project has a standard layout:
-```
-.
-├── src/                  # Source code directory
-│   └── {{ name.lower() }}/
-│       ├── __init__.py
-│       └── mcp.py        # Server is launched here
-│       └── app.py        # Application tools are defined here
-├── tests/                # Directory for project tests
-├── .env                  # Environment variables (for local development)
-├── pyproject.toml        # Project dependencies managed by uv
-├── README.md             # This file
-```
-
-## 📝 License
-
-This project is licensed under the MIT License.
-
----
-
-_This project was generated using **MCP CLI** — Happy coding! 🚀_
-
-## Usage
-
-- Login to AgentR
-- Follow the quickstart guide to setup MCP Server for your client
-- Visit Apps Store and enable the {{ name }} app
-- Restart the MCP Server
-
-### Local Development
-
-- Follow the README to test with the local MCP Server 

universal_mcp/utils/dump_app_tools.py

@@ -1,78 +0,0 @@
-import csv
-from pathlib import Path
-
-from universal_mcp.applications import app_from_slug
-
-
-def discover_available_app_slugs():
-    apps_dir = Path(__file__).resolve().parent.parent / "applications"
-    app_slugs = []
-
-    for item in apps_dir.iterdir():
-        if not item.is_dir() or item.name.startswith("_"):
-            continue
-
-        if (item / "app.py").exists():
-            slug = item.name.replace("_", "-")
-            app_slugs.append(slug)
-
-    return app_slugs
-
-
-def extract_app_tools(app_slugs):
-    all_apps_tools = []
-
-    for slug in app_slugs:
-        try:
-            print(f"Loading app: {slug}")
-            app_class = app_from_slug(slug)
-
-            app_instance = app_class(integration=None)
-
-            tools = app_instance.list_tools()
-
-            for tool in tools:
-                tool_name = tool.__name__
-                description = (
-                    tool.__doc__.strip().split("\n")[0]
-                    if tool.__doc__
-                    else "No description"
-                )
-
-                all_apps_tools.append(
-                    {
-                        "app_name": slug,
-                        "tool_name": tool_name,
-                        "description": description,
-                    }
-                )
-
-        except Exception as e:
-            print(f"Error loading app {slug}: {e}")
-
-    return all_apps_tools
-
-
-def write_to_csv(app_tools, output_file="app_tools.csv"):
-    fieldnames = ["app_name", "tool_name", "description"]
-
-    with open(output_file, "w", newline="") as csvfile:
-        writer = csv.DictWriter(csvfile, fieldnames=fieldnames)
-        writer.writeheader()
-        writer.writerows(app_tools)
-
-    print(f"CSV file created: {output_file}")
-
-
-def main():
-    app_slugs = discover_available_app_slugs()
-    print(f"Found {len(app_slugs)} app slugs: {', '.join(app_slugs)}")
-
-    app_tools = extract_app_tools(app_slugs)
-    print(f"Extracted {len(app_tools)} tools from all apps")
-
-    write_to_csv(app_tools)
-
-
-if __name__ == "__main__":
-    main()