universal-mcp 0.1.1__tar.gz → 0.1.2rc1__tar.gz

universal_mcp-0.1.2rc1/.github/workflows/publish-pypi.yml

@@ -0,0 +1,48 @@
+name: Publishing
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  release-build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    needs: [checks]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Build
+        run: uv build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  checks:
+    uses: ./.github/workflows/shared.yml
+
+  pypi-publish:
+    name: Upload release to PyPI
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      id-token: write # IMPORTANT: this permission is mandatory for trusted publishing
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

universal_mcp-0.1.2rc1/.github/workflows/pull-request-checks.yml

@@ -0,0 +1,8 @@
+name: Pull request checks
+
+on:
+  pull_request:
+
+jobs:
+  checks:
+    uses: ./.github/workflows/shared.yml

universal_mcp-0.1.2rc1/.github/workflows/shared.yml

@@ -0,0 +1,54 @@
+name: Shared Checks
+
+on:
+  workflow_call:
+
+jobs:
+  format:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Install the project
+        run: uv sync --frozen --all-extras --dev
+
+      - name: Run ruff format check
+        run: uv run --no-sync ruff check .
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Install the project
+        run: uv sync --frozen --all-extras --dev
+
+    #   - name: Run pyright
+    #     run: uv run --no-sync pyright
+
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Install the project
+        run: uv sync --frozen --all-extras --dev
+
+      - name: Run pytest
+        run: uv run --no-sync pytest

universal_mcp-0.1.2rc1/.gitignore

@@ -0,0 +1,47 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Environment variables
+.env
+.env.local
+
+
+dump/
+
+
+# SQLite database
+*.db
+*.sqlite
+*.sqlite3
+*.db-shm
+*.db-wal
+
+
+# Pyright
+.pyright
+
+# Ruff
+.ruff_cache
+
+# Pytest
+.pytest_cache
+
+
+# Local config
+local_config.json
+
+
+# Test Artifacts
+test_artifacts/
+src/universal_mcp/applications/complex/
+src/universal_mcp/applications/test/
+src/universal_mcp/applications/test_with_docs/
+src/universal_mcp/applications/test_without_docs/

universal_mcp-0.1.2rc1/.pre-commit-config.yaml

@@ -0,0 +1,24 @@
+fail_fast: true
+
+repos:
+  - repo: https://github.com/pre-commit/mirrors-prettier
+    rev: v3.1.0
+    hooks:
+      - id: prettier
+        types_or: [yaml, json5]
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.1
+    hooks:
+      - id: ruff-format
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+
+  - repo: local
+    hooks:
+      - id: uv-lock-check
+        name: Check uv.lock is up to date
+        entry: uv lock --check
+        language: system
+        files: ^(pyproject\.toml|uv\.lock)$
+        pass_filenames: false

{universal_mcp-0.1.1 → universal_mcp-0.1.2rc1}/PKG-INFO

@@ -1,25 +1,38 @@
 Metadata-Version: 2.4
 Name: universal-mcp
-Version: 0.1.1
+Version: 0.1.2rc1
 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>
 Requires-Python: >=3.11
+Requires-Dist: keyring>=25.6.0
+Requires-Dist: litellm>=1.30.7
 Requires-Dist: loguru>=0.7.3
+Requires-Dist: markitdown[all]>=0.1.1
 Requires-Dist: mcp>=1.5.0
 Requires-Dist: pydantic-settings>=2.8.1
 Requires-Dist: pydantic>=2.11.1
 Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: typer>=0.15.2
+Provides-Extra: dev
+Requires-Dist: litellm>=1.30.7; 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: firecrawl
+Requires-Dist: firecrawl-py>=1.15.0; extra == 'firecrawl'
 Provides-Extra: playground
 Requires-Dist: fastapi[standard]>=0.115.12; extra == 'playground'
 Requires-Dist: langchain-anthropic>=0.3.10; extra == 'playground'
 Requires-Dist: langchain-mcp-adapters>=0.0.3; extra == 'playground'
 Requires-Dist: langgraph-checkpoint-sqlite>=2.0.6; extra == 'playground'
 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'
-Provides-Extra: test
-Requires-Dist: pytest-asyncio>=0.26.0; extra == 'test'
-Requires-Dist: pytest>=8.3.5; extra == 'test'
+Provides-Extra: serpapi
+Requires-Dist: google-search-results>=2.4.2; extra == 'serpapi'
 Description-Content-Type: text/markdown
 
 # Universal MCP
@@ -166,7 +179,11 @@ AgentR includes a command-line interface for common operations:
 agentr version
 
 # Generate API client from OpenAPI schema
-agentr generate --schema path/to/openapi.yaml
+
+# Use the name of the API as the output filename (e.g., twitter, petstore, github)
+universal_mcp generate --schema petstore.json --output outputfilename
+
+# The tool will create src/universal_mcp/applications/petstore/ with app.py and README.md
 
 # Run the test server
 agentr run

{universal_mcp-0.1.1 → universal_mcp-0.1.2rc1}/README.md

@@ -142,7 +142,11 @@ AgentR includes a command-line interface for common operations:
 agentr version
 
 # Generate API client from OpenAPI schema
-agentr generate --schema path/to/openapi.yaml
+
+# Use the name of the API as the output filename (e.g., twitter, petstore, github)
+universal_mcp generate --schema petstore.json --output outputfilename
+
+# The tool will create src/universal_mcp/applications/petstore/ with app.py and README.md
 
 # Run the test server
 agentr run

universal_mcp-0.1.2rc1/local_config.json.example

@@ -0,0 +1,11 @@
+{
+    "name": "Local Server",
+    "description": "Local server for testing",
+    "type": "local",
+    "transport": "sse",
+    "apps": [
+        {
+            "name": "markitdown"
+        }
+    ]
+}

universal_mcp-0.1.2rc1/pyproject.toml

@@ -0,0 +1,149 @@
+[project]
+name = "universal-mcp"
+version = "0.1.2rc1"
+description = "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."
+readme = "README.md"
+authors = [
+    { name = "Manoj Bajaj", email = "manojbajaj95@gmail.com" }
+]
+requires-python = ">=3.11"
+dependencies = [
+    "pydantic>=2.11.1",
+    "pydantic-settings>=2.8.1",
+    "loguru>=0.7.3",
+    "mcp>=1.5.0",
+    "pyyaml>=6.0.2",
+    "typer>=0.15.2",
+    "markitdown[all]>=0.1.1",
+    "keyring>=25.6.0",
+    "litellm>=1.30.7",
+]
+
+[project.optional-dependencies]
+playground = [
+    "fastapi[standard]>=0.115.12",
+    "langchain-anthropic>=0.3.10",
+    "langchain-mcp-adapters>=0.0.3",
+    "langgraph>=0.3.24",
+    "langgraph-checkpoint-sqlite>=2.0.6",
+    "streamlit>=1.44.1",
+    "python-dotenv>=1.0.1",
+]
+dev = [
+    "ruff>=0.11.4",
+    "pytest>=8.3.5",
+    "pytest-asyncio>=0.26.0",
+    "pyright>=1.1.398",
+    "litellm>=1.30.7",
+]
+e2b = [
+    "e2b-code-interpreter>=1.2.0",
+]
+firecrawl=[
+    "firecrawl-py>=1.15.0",
+]
+serpapi = [
+    "google-search-results>=2.4.2",
+]
+[project.scripts]
+universal_mcp = "universal_mcp.cli:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.ruff]
+# Exclude a variety of commonly ignored directories.
+exclude = [
+    ".bzr",
+    ".direnv",
+    ".eggs",
+    ".git",
+    ".git-rewrite",
+    ".hg",
+    ".ipynb_checkpoints",
+    ".mypy_cache",
+    ".nox",
+    ".pants.d",
+    ".pyenv",
+    ".pytest_cache",
+    ".pytype",
+    ".ruff_cache",
+    ".svn",
+    ".tox",
+    ".venv",
+    ".vscode",
+    "__pypackages__",
+    "_build",
+    "buck-out",
+    "build",
+    "dist",
+    "node_modules",
+    "site-packages",
+    "venv",
+]
+
+# Same as Black.
+line-length = 88
+indent-width = 4
+
+# Assume Python 3.12
+target-version = "py312"
+
+[tool.ruff.lint]
+# Enable Pyflakes (`F`) and a subset of the pycodestyle (`E`)  codes by default.
+# Unlike Flake8, Ruff doesn't enable pycodestyle warnings (`W`) or
+# McCabe complexity (`C901`) by default.
+select = [
+    # pycodestyle
+    "E",
+    # Pyflakes
+    "F",
+    # pyupgrade
+    "UP",
+    # flake8-bugbear
+    "B",
+    # flake8-simplify
+    "SIM",
+    # isort
+    "I",
+]
+ignore = ['E501', 'B008']
+
+# Allow fix for all enabled rules (when `--fix`) is provided.
+fixable = ["ALL"]
+unfixable = []
+
+# Allow unused variables when underscore-prefixed.
+dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+
+[tool.ruff.format]
+# Like Black, use double quotes for strings.
+quote-style = "double"
+
+# Like Black, indent with spaces, rather than tabs.
+indent-style = "space"
+
+# Like Black, respect magic trailing commas.
+skip-magic-trailing-comma = false
+
+# Like Black, automatically detect the appropriate line ending.
+line-ending = "auto"
+
+# Enable auto-formatting of code examples in docstrings. Markdown,
+# reStructuredText code/literal blocks and doctests are all supported.
+#
+# This is currently disabled by default, but it is planned for this
+# to be opt-out in the future.
+docstring-code-format = false
+
+# Set the line length limit used when formatting code snippets in
+# docstrings.
+#
+# This only has an effect when the `docstring-code-format` setting is
+# enabled.
+docstring-code-line-length = "dynamic"
+
+[tool.pytest.ini_options]
+asyncio_mode = "strict"
+asyncio_default_fixture_loop_scope = "function"

universal_mcp-0.1.2rc1/src/playground/README.md

@@ -0,0 +1,65 @@
+## Running the Playground
+
+### Automated Startup (Recommended)
+
+To easily start all necessary services (MCP Server, FastAPI Backend, Streamlit Frontend), you can use the provided Python startup script. This script will attempt to open each service in sequence and ensures they are terminated gracefully upon interruption.
+
+**Prerequisites:**
+
+*   Python 3 installed and available in your PATH.
+*   All project dependencies installed (ensure you've run `pip install ...` for all requirements).
+*   **`local_config.json` file:** This configuration file for the MCP server must exist in the **project root directory**. It should contain a JSON array defining the MCP tools to load. For example:
+    ```json
+    {
+        "name": "Local Server",
+        "description": "Local server for testing",
+        "type": "local",
+        "transport": "sse",
+        "apps": [
+            {
+                "name": "zenquotes"
+            }
+        ]
+    }
+    ```
+    *(Adapt the content based on the actual MCP tools you intend to use.)*
+*   A compatible terminal environment for the script:
+    *   On **macOS**, requires the standard `Terminal.app`.
+    *   On **Linux**, assumes `gnome-terminal` is available (common on Ubuntu/Fedora). You may need to modify `src/playground/__main__.py` if you use a different terminal like `konsole` or `xfce4-terminal`.
+    *   On **Windows**, requires the standard `cmd.exe`.
+
+**Instructions:**
+
+1.  Open your terminal application.
+2.  Navigate (`cd`) to the **root directory** of this project (the directory containing the `src/` folder and `local_config.json`).
+3.  Execute the startup script using Python:
+
+    ```bash
+    python src/playground
+    ```
+
+    *(Note: If your system uses `python3` to invoke Python 3, use that command instead: `python3 src/playground`)*
+
+After running the command, you should see messages indicating that the components are being launched.
+
+### Manual Startup (Alternative)
+
+If you prefer, or if the automated script does not work on your specific system configuration, you can still start each component manually. Make sure you run each command from the **project root directory** in a separate terminal window:
+
+1.  **Terminal 1 (MCP Server):**
+    *(Ensure `local_config.json` exists in the project root as described above)*
+    ```bash
+    universal_mcp run -c local_config.json
+    ```
+2.  **Terminal 2 (FastAPI App):**
+    ```bash
+    fastapi run src/playground
+    ```
+3.  **Terminal 3 (Streamlit App):**
+    ```bash
+    streamlit run src/playground/streamlit.py
+    ```
+
+### Stopping the Services
+
+To stop the running services, go to each of the terminal windows that were opened (either by the script or manually) and press `Ctrl + C`.

universal_mcp-0.1.2rc1/src/playground/__main__.py

@@ -0,0 +1,37 @@
+import subprocess
+import time
+
+from loguru import logger
+
+
+def main():
+    processes = []
+
+    # Start MCP server first
+    mcp_process = subprocess.Popen(["universal_mcp", "run", "-c", "local_config.json"])
+    processes.append(mcp_process)
+    time.sleep(3)  # Give MCP server time to start
+    logger.info("MCP server started")
+
+    # Start FastAPI app second
+    fastapi_process = subprocess.Popen(["fastapi", "run", "src/playground"])
+    processes.append(fastapi_process)
+    time.sleep(3)  # Give FastAPI time to start
+    logger.info("FastAPI app started")
+    # Start Streamlit app last
+    streamlit_process = subprocess.Popen(
+        ["streamlit", "run", "src/playground/streamlit.py"]
+    )
+    processes.append(streamlit_process)
+    logger.info("Streamlit app started")
+    try:
+        for p in processes:
+            p.wait()
+    except KeyboardInterrupt:
+        for p in processes:
+            p.terminate()
+            p.wait()
+
+
+if __name__ == "__main__":
+    main()

{universal_mcp-0.1.1 → universal_mcp-0.1.2rc1}/src/playground/agents/react.py

@@ -1,9 +1,10 @@
+import asyncio
 from contextlib import asynccontextmanager
+
 from langchain_anthropic import ChatAnthropic
-from langgraph.prebuilt import create_react_agent
 from langchain_core.messages import HumanMessage
-import asyncio
 from langchain_mcp_adapters.client import MultiServerMCPClient
+from langgraph.prebuilt import create_react_agent
 
 
 @asynccontextmanager

{universal_mcp-0.1.1 → universal_mcp-0.1.2rc1}/src/playground/client.py

@@ -56,7 +56,7 @@ class AgentClient:
             )
             response.raise_for_status()
         except httpx.HTTPError as e:
-            raise AgentClientError(f"Error getting service info: {e}")
+            raise AgentClientError(f"Error getting service info: {e}") from e
 
     async def ainvoke(
         self,
@@ -92,7 +92,7 @@ class AgentClient:
                 )
                 response.raise_for_status()
             except httpx.HTTPError as e:
-                raise AgentClientError(f"Error: {e}")
+                raise AgentClientError(f"Error: {e}") from e
 
         return ChatMessage.model_validate(response.json())
 
@@ -131,7 +131,7 @@ class AgentClient:
             )
             response.raise_for_status()
         except httpx.HTTPError as e:
-            raise AgentClientError(f"Error: {e}")
+            raise AgentClientError(f"Error: {e}") from e
 
         return ChatMessage.model_validate(response.json())
 
@@ -144,14 +144,14 @@ class AgentClient:
             try:
                 parsed = json.loads(data)
             except Exception as e:
-                raise Exception(f"Error JSON parsing message from server: {e}")
+                raise Exception(f"Error JSON parsing message from server: {e}") from e
             match parsed["type"]:
                 case "message":
                     # Convert the JSON formatted message to an AnyMessage
                     try:
                         return ChatMessage.model_validate(parsed["content"])
                     except Exception as e:
-                        raise Exception(f"Server returned invalid message: {e}")
+                        raise Exception(f"Server returned invalid message: {e}") from e
                 case "token":
                     # Yield the str token directly
                     return parsed["content"]
@@ -208,7 +208,7 @@ class AgentClient:
                             break
                         yield parsed
         except httpx.HTTPError as e:
-            raise AgentClientError(f"Error: {e}")
+            raise AgentClientError(f"Error: {e}") from e
 
     async def astream(
         self,
@@ -261,7 +261,7 @@ class AgentClient:
                                 break
                             yield parsed
             except httpx.HTTPError as e:
-                raise AgentClientError(f"Error: {e}")
+                raise AgentClientError(f"Error: {e}") from e
 
     def get_history(
         self,
@@ -283,6 +283,6 @@ class AgentClient:
             )
             response.raise_for_status()
         except httpx.HTTPError as e:
-            raise AgentClientError(f"Error: {e}")
+            raise AgentClientError(f"Error: {e}") from e
 
         return ChatHistory.model_validate(response.json())

{universal_mcp-0.1.1 → universal_mcp-0.1.2rc1}/src/playground/schema.py

@@ -1,5 +1,6 @@
+from typing import Any, Literal, NotRequired, TypedDict
+
 from pydantic import BaseModel, Field
-from typing import Any, Literal, TypedDict, NotRequired
 
 
 class UserInput(BaseModel):

{universal_mcp-0.1.1 → universal_mcp-0.1.2rc1}/src/playground/service.py

@@ -11,6 +11,7 @@ from langchain_core._api import LangChainBetaWarning
 from langchain_core.messages import AnyMessage, HumanMessage
 from langchain_core.runnables import RunnableConfig
 from langgraph.types import Command
+from loguru import logger
 
 from playground.agents.react import create_agent
 from playground.memory import initialize_database
@@ -26,7 +27,6 @@ from playground.utils import (
     langchain_to_chat_message,
     remove_tool_calls,
 )
-from loguru import logger
 
 warnings.filterwarnings("ignore", category=LangChainBetaWarning)
 
@@ -40,13 +40,12 @@ async def lifespan(app: FastAPI) -> AsyncGenerator[None, None]:
     Configurable lifespan that initializes the appropriate database checkpointer based on settings.
     """
     try:
-        async with create_agent() as react_agent:
-            async with initialize_database() as saver:
-                await saver.setup()
-                global agent
-                agent = react_agent
-                agent.checkpointer = saver
-                yield
+        async with create_agent() as react_agent, initialize_database() as saver:
+            await saver.setup()
+            global agent
+            agent = react_agent
+            agent.checkpointer = saver
+            yield
     except Exception as e:
         logger.error(f"Error during database initialization: {e}")
         raise
@@ -102,7 +101,7 @@ async def invoke(user_input: UserInput) -> ChatMessage:
         return output
     except Exception as e:
         logger.error(f"An exception occurred: {e}")
-        raise HTTPException(status_code=500, detail="Unexpected error")
+        raise HTTPException(status_code=500, detail="Unexpected error") from e
 
 
 async def message_generator(user_input: StreamInput) -> AsyncGenerator[str, None]:
@@ -223,7 +222,7 @@ def history(input: ChatHistoryInput) -> ChatHistory:
         return ChatHistory(messages=chat_messages)
     except Exception as e:
         logger.error(f"An exception occurred: {e}")
-        raise HTTPException(status_code=500, detail="Unexpected error")
+        raise HTTPException(status_code=500, detail="Unexpected error") from e
 
 
 @app.get("/health")

{universal_mcp-0.1.1 → universal_mcp-0.1.2rc1}/src/playground/settings.py

@@ -1,4 +1,5 @@
 from pathlib import Path
+
 from pydantic_settings import BaseSettings, SettingsConfigDict