universal-mcp 0.1.12__tar.gz → 0.1.13__tar.gz

{universal_mcp-0.1.12 → universal_mcp-0.1.13}/.gitignore

@@ -44,4 +44,7 @@ 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/
+src/universal_mcp/applications/test_without_docs/
+
+# Temporary files
+tmp/

{universal_mcp-0.1.12 → universal_mcp-0.1.13}/PKG-INFO

@@ -1,13 +1,14 @@
 Metadata-Version: 2.4
 Name: universal-mcp
-Version: 0.1.12
+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.12 → universal_mcp-0.1.13}/README.md

@@ -8,6 +8,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
 
@@ -105,27 +107,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`.
@@ -210,6 +192,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/pyproject.toml

@@ -0,0 +1,127 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "universal-mcp"
+version = "0.1.13"
+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"
+license = { text = "MIT" }
+dependencies = [
+    "Jinja2>=3.1.3",
+    "cookiecutter>=2.6.0",
+    "gql[all]>=3.5.2",
+    "keyring>=25.6.0",
+    "litellm>=1.30.7",
+    "loguru>=0.7.3",
+    "mcp>=1.6.0",
+    "posthog>=3.24.0",
+    "pydantic>=2.11.1",
+    "pydantic-settings>=2.8.1",
+    "pyyaml>=6.0.2",
+    "rich>=14.0.0",
+    "typer>=0.15.2",
+]
+
+[project.optional-dependencies]
+dev = [
+    "litellm>=1.30.7",
+    "pre-commit>=4.2.0",
+    "pyright>=1.1.398",
+    "pytest>=8.3.5",
+    "pytest-asyncio>=0.26.0",
+    "ruff>=0.11.4",
+]
+playground = [
+    "langchain-mcp-adapters>=0.0.3",
+    "langchain-openai>=0.3.12",
+    "langgraph>=0.3.24",
+    "langgraph-checkpoint-sqlite>=2.0.6",
+    "python-dotenv>=1.0.1",
+    "streamlit>=1.44.1",
+    "watchdog>=6.0.0",
+]
+
+[project.scripts]
+universal_mcp = "universal_mcp.cli:app"
+
+# ------------------------------
+# Hatch build configuration
+# ------------------------------
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/templates", # Important: Include the templates directory!
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/universal_mcp"]
+
+[tool.hatch.build.targets.wheel.shared-data]
+"templates" = "universal_mcp/templates"
+
+# ------------------------------
+# Tool configurations
+# ------------------------------
+[tool.ruff]
+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",
+]
+line-length = 88
+indent-width = 4
+target-version = "py312"
+
+[tool.ruff.lint]
+select = [
+    "E",    # pycodestyle
+    "F",    # Pyflakes
+    "UP",   # pyupgrade
+    "B",    # flake8-bugbear
+    "SIM",  # flake8-simplify
+    "I",    # isort
+]
+ignore = ['E501', 'B008']
+fixable = ["ALL"]
+unfixable = []
+dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+docstring-code-line-length = "dynamic"
+
+[tool.pytest.ini_options]
+asyncio_mode = "strict"
+asyncio_default_fixture_loop_scope = "function"

{universal_mcp-0.1.12 → universal_mcp-0.1.13}/src/playground/__main__.py

@@ -8,19 +8,16 @@ def main():
     processes = []
 
     # Start MCP server first
-    mcp_process = subprocess.Popen(["universal_mcp", "run", "-c", "local_config.json"])
-    processes.append(mcp_process)
-    time.sleep(6)  # Give MCP server time to start
-    logger.info("MCP server started")
+    # Ask the user if they want to run the MCP server
+    run_mcp_server = input("Do you want to run the MCP server? (y/n): ")
+    if run_mcp_server == "y":
+        mcp_process = subprocess.Popen(
+            ["universal_mcp", "run", "-c", "local_config.json"]
+        )
+        processes.append(mcp_process)
+        time.sleep(6)  # Give MCP server time to start
+        logger.info("MCP server started")
 
-    # Start FastAPI app second
-    fastapi_process = subprocess.Popen(
-        ["fastapi", "run", "src/playground", "--port", "8003"]
-    )
-    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"]
     )

{universal_mcp-0.1.12 → universal_mcp-0.1.13}/src/playground/agents/react.py

@@ -12,7 +12,7 @@ async def load_tools():
     async with MultiServerMCPClient(
         {
             "agentr": {
-                "url": "http://localhost:8000/sse",
+                "url": "http://localhost:8005/sse",
                 "transport": "sse",
             },
         }