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

universal_mcp-0.1.1rc1/.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.1rc1/.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.1rc1/.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.1rc1/.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.1rc1/.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.1rc1/CONTRIBUTING.md

@@ -0,0 +1,78 @@
+# Contributing to AgentR
+
+Thank you for your interest in contributing to AgentR! This document provides guidelines and instructions for contributing to the project.
+
+## 🚀 Getting Started
+
+1. Fork the repository at git@github.com:AgentrDev/universal-mcp.git
+2. Clone your fork
+3. Create a new branch for your changes:
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+4. Install development dependencies:
+   ```bash
+   pip install -e ".[test]"
+   ```
+
+5. Make your changes and ensure tests pass:
+   ```bash
+   pytest
+   ```
+
+6. Commit your changes following conventional commits:
+   ```bash
+   git commit -m "feat: add new feature"
+   ```
+
+7. Push to your fork:
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+
+8. Open a Pull Request against the main repository
+
+## 📝 Guidelines
+
+### Code Style
+- Follow PEP 8 guidelines
+- Use type hints where possible
+- Include docstrings for functions and classes
+- Keep functions focused and single-purpose
+
+### Testing
+- Add tests for new features
+- Ensure all tests pass before submitting PR
+- Maintain or improve code coverage
+
+### Pull Requests
+- Keep PRs focused on a single change
+- Include a clear description of changes
+- Reference any related issues
+- Update documentation as needed
+
+### Commit Messages
+Follow conventional commits format:
+- feat: New feature
+- fix: Bug fix
+- docs: Documentation changes
+- style: Code style changes
+- refactor: Code refactoring
+- test: Test updates
+- chore: Maintenance tasks
+
+## 🐛 Reporting Issues
+
+- Search existing issues before creating new ones
+- Include clear steps to reproduce
+- Provide system information
+- Add relevant logs or screenshots
+
+## 📚 Documentation
+
+- Keep README.md updated
+- Document new features
+- Include docstrings
+- Update CHANGELOG.md for significant changes
+

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

@@ -1,18 +1,38 @@
 Metadata-Version: 2.4
 Name: universal-mcp
-Version: 0.1.0
+Version: 0.1.1rc1
 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: test
-Requires-Dist: pytest-asyncio>=0.26.0; extra == 'test'
-Requires-Dist: pytest>=8.3.5; extra == 'test'
+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: serpapi
+Requires-Dist: google-search-results>=2.4.2; extra == 'serpapi'
 Description-Content-Type: text/markdown
 
 # Universal MCP
@@ -87,6 +107,24 @@ if __name__ == "__main__":
     server.run()
 ```
 
+## Using Playground
+
+Start MCP Server
+```bash
+universal_mcp run -t sse
+```
+
+Start FastAPI app
+```bash
+fastapi run src/playground
+```
+
+Start Frontend
+```bash
+streamlit run src/playground/streamlit.py
+```
+
+
 ## 🧩 Available Applications
 AgentR comes with several pre-built applications:
 
@@ -141,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.0 → universal_mcp-0.1.1rc1}/README.md

@@ -70,6 +70,24 @@ if __name__ == "__main__":
     server.run()
 ```
 
+## Using Playground
+
+Start MCP Server
+```bash
+universal_mcp run -t sse
+```
+
+Start FastAPI app
+```bash
+fastapi run src/playground
+```
+
+Start Frontend
+```bash
+streamlit run src/playground/streamlit.py
+```
+
+
 ## 🧩 Available Applications
 AgentR comes with several pre-built applications:
 
@@ -124,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.1rc1/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.1rc1/pyproject.toml

@@ -0,0 +1,149 @@
+[project]
+name = "universal-mcp"
+version = "0.1.1rc1"
+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.1rc1/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.1rc1/src/playground/__init__.py

@@ -0,0 +1,3 @@
+from playground.service import app
+
+__all__ = ["app"]

universal_mcp-0.1.1rc1/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.1rc1/src/playground/agents/react.py

@@ -0,0 +1,51 @@
+import asyncio
+from contextlib import asynccontextmanager
+
+from langchain_anthropic import ChatAnthropic
+from langchain_core.messages import HumanMessage
+from langchain_mcp_adapters.client import MultiServerMCPClient
+from langgraph.prebuilt import create_react_agent
+
+
+@asynccontextmanager
+async def load_tools():
+    async with MultiServerMCPClient(
+        {
+            "agentr": {
+                "url": "http://localhost:8005/sse",
+                "transport": "sse",
+            },
+        }
+    ) as client:
+        tools = client.get_tools()
+        yield tools
+
+
+@asynccontextmanager
+async def create_agent():
+    llm = ChatAnthropic(model="claude-3-5-sonnet-latest")
+    async with load_tools() as tools:
+        yield create_react_agent(
+            model=llm,
+            tools=tools,
+            debug=False,
+        )
+
+
+async def main():
+    async with create_agent() as agent:
+        print("Welcome to the agent!")
+        messages = []
+        while True:
+            human_input = input("Enter your message: ")
+            if human_input.lower() in ["exit", "quit", "q"]:
+                break
+            messages.append(HumanMessage(content=human_input))
+            results = await agent.ainvoke({"messages": messages})
+            ai_message = results["messages"][-1]
+            messages.append(ai_message)
+            print(ai_message.content)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())