universal-mcp 0.1.0__tar.gz

universal_mcp-0.1.0/.gitignore

@@ -0,0 +1,17 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Environment variables
+.env
+.env.local
+
+
+dump/

universal_mcp-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

universal_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: universal-mcp
+Version: 0.1.0
+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: loguru>=0.7.3
+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'
+Description-Content-Type: text/markdown
+
+# Universal MCP
+
+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.
+
+
+## 🌟 Features
+
+- **MCP (Model Context Protocol) Integration**: Seamlessly works with MCP server architecture
+- **Simplified API Integration**: Connect to services like GitHub, Google Calendar, Gmail, Reddit, Tavily, and more with minimal code
+- **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
+
+## 🔧 Installation
+
+Install AgentR using pip:
+
+```bash
+pip install universal-mcp
+```
+
+## 🚀 Quick Start
+
+### 1. Get an API Key
+Before using AgentR with services that require authorization (like GitHub, Gmail, etc.), you'll need an AgentR API key:
+
+Visit https://agentr.dev to create an account
+Generate an API key from your dashboard
+Set it as an environment variable or include it directly in your code:
+
+```bash
+export AGENTR_API_KEY="your_api_key_here"
+```
+
+### 2. Create a basic server
+
+```bash
+from agentr.server import TestServer
+
+# Define your applications list
+apps_list = [
+    {
+        "name": "tavily",
+        "integration": {
+            "name": "tavily_api_key",
+            "type": "api_key",
+            "store": {
+                "type": "environment",
+            }
+        },        
+    },
+    {
+        "name": "zenquotes",
+        "integration": None
+    },
+    {
+        "name": "github",
+        "integration": {
+            "name": "github",
+            "type": "agentr",
+        }
+    }
+]
+
+# Create a server with these applications
+server = TestServer(name="My Agent Server", description="A server for my agent apps", apps_list=apps_list)
+
+# Run the server
+if __name__ == "__main__":
+    server.run()
+```
+
+## 🧩 Available Applications
+AgentR comes with several pre-built applications:
+
+| Application | Description | Authentication Type |
+|-------------|-------------|---------------------|
+| GitHub | Star repositories and more | OAuth (AgentR) |
+| Google Calendar | Retrieve calendar events | OAuth (AgentR) |
+| Gmail | Send emails | OAuth (AgentR) |
+| Reddit | Access Reddit data | OAuth (AgentR) |
+| Resend | Send emails via Resend API | API Key |
+| Tavily | Web search capabilities | API Key |
+| ZenQuotes | Get inspirational quotes | None |
+
+> **Note**: More applications are coming soon! Stay tuned for updates to our application catalog.
+
+## 🔐 Integration Types
+AgentR supports two primary integration types:
+
+### 1. API Key Integration
+For services that authenticate via API keys:
+```python
+{
+    "name": "service_name",
+    "integration": {
+        "name": "service_api_key",
+        "type": "api_key",
+        "store": {
+            "type": "environment",  # or "memory"
+        }
+    }
+}
+```
+
+### 2. OAuth Integration (via AgentR)
+For services requiring OAuth flow:
+```python
+{
+    "name": "service_name",
+    "integration": {
+        "name": "service_name",
+        "type": "agentr"
+    }
+}
+```
+When using OAuth integrations, users will be directed to authenticate with the service provider through a secure flow managed by AgentR.
+
+## 🤖 CLI Usage
+AgentR includes a command-line interface for common operations:
+
+```bash
+# Get version information
+agentr version
+
+# Generate API client from OpenAPI schema
+agentr generate --schema path/to/openapi.yaml
+
+# Run the test server
+agentr run
+
+# Install AgentR for specific applications
+agentr install claude
+```
+
+## 📋 Requirements
+
+- Python 3.11+
+- Dependencies (automatically installed):
+  - loguru >= 0.7.3
+  - mcp >= 1.5.0
+  - pyyaml >= 6.0.2
+  - typer >= 0.15.2
+
+
+## 📝 License
+
+This project is licensed under the MIT License.

universal_mcp-0.1.0/README.md

@@ -0,0 +1,148 @@
+# Universal MCP
+
+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.
+
+
+## 🌟 Features
+
+- **MCP (Model Context Protocol) Integration**: Seamlessly works with MCP server architecture
+- **Simplified API Integration**: Connect to services like GitHub, Google Calendar, Gmail, Reddit, Tavily, and more with minimal code
+- **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
+
+## 🔧 Installation
+
+Install AgentR using pip:
+
+```bash
+pip install universal-mcp
+```
+
+## 🚀 Quick Start
+
+### 1. Get an API Key
+Before using AgentR with services that require authorization (like GitHub, Gmail, etc.), you'll need an AgentR API key:
+
+Visit https://agentr.dev to create an account
+Generate an API key from your dashboard
+Set it as an environment variable or include it directly in your code:
+
+```bash
+export AGENTR_API_KEY="your_api_key_here"
+```
+
+### 2. Create a basic server
+
+```bash
+from agentr.server import TestServer
+
+# Define your applications list
+apps_list = [
+    {
+        "name": "tavily",
+        "integration": {
+            "name": "tavily_api_key",
+            "type": "api_key",
+            "store": {
+                "type": "environment",
+            }
+        },        
+    },
+    {
+        "name": "zenquotes",
+        "integration": None
+    },
+    {
+        "name": "github",
+        "integration": {
+            "name": "github",
+            "type": "agentr",
+        }
+    }
+]
+
+# Create a server with these applications
+server = TestServer(name="My Agent Server", description="A server for my agent apps", apps_list=apps_list)
+
+# Run the server
+if __name__ == "__main__":
+    server.run()
+```
+
+## 🧩 Available Applications
+AgentR comes with several pre-built applications:
+
+| Application | Description | Authentication Type |
+|-------------|-------------|---------------------|
+| GitHub | Star repositories and more | OAuth (AgentR) |
+| Google Calendar | Retrieve calendar events | OAuth (AgentR) |
+| Gmail | Send emails | OAuth (AgentR) |
+| Reddit | Access Reddit data | OAuth (AgentR) |
+| Resend | Send emails via Resend API | API Key |
+| Tavily | Web search capabilities | API Key |
+| ZenQuotes | Get inspirational quotes | None |
+
+> **Note**: More applications are coming soon! Stay tuned for updates to our application catalog.
+
+## 🔐 Integration Types
+AgentR supports two primary integration types:
+
+### 1. API Key Integration
+For services that authenticate via API keys:
+```python
+{
+    "name": "service_name",
+    "integration": {
+        "name": "service_api_key",
+        "type": "api_key",
+        "store": {
+            "type": "environment",  # or "memory"
+        }
+    }
+}
+```
+
+### 2. OAuth Integration (via AgentR)
+For services requiring OAuth flow:
+```python
+{
+    "name": "service_name",
+    "integration": {
+        "name": "service_name",
+        "type": "agentr"
+    }
+}
+```
+When using OAuth integrations, users will be directed to authenticate with the service provider through a secure flow managed by AgentR.
+
+## 🤖 CLI Usage
+AgentR includes a command-line interface for common operations:
+
+```bash
+# Get version information
+agentr version
+
+# Generate API client from OpenAPI schema
+agentr generate --schema path/to/openapi.yaml
+
+# Run the test server
+agentr run
+
+# Install AgentR for specific applications
+agentr install claude
+```
+
+## 📋 Requirements
+
+- Python 3.11+
+- Dependencies (automatically installed):
+  - loguru >= 0.7.3
+  - mcp >= 1.5.0
+  - pyyaml >= 6.0.2
+  - typer >= 0.15.2
+
+
+## 📝 License
+
+This project is licensed under the MIT License.

universal_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[project]
+name = "universal-mcp"
+version = "0.1.0"
+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",
+]
+
+[project.optional-dependencies]
+test = [
+  "pytest>=8.3.5",
+  "pytest-asyncio>=0.26.0",
+]
+
+[project.scripts]
+universal_mcp = "universal_mcp.cli:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+

universal_mcp-0.1.0/src/universal_mcp/__init__.py

@@ -0,0 +1,2 @@
+def hello() -> str:
+    return "Hello from universal-mcp!"

universal_mcp-0.1.0/src/universal_mcp/applications/__init__.py

@@ -0,0 +1,31 @@
+from universal_mcp.applications.zenquotes.app import ZenQuoteApp
+from universal_mcp.applications.tavily.app import TavilyApp
+from universal_mcp.applications.github.app import GithubApp
+from universal_mcp.applications.google_calendar.app import GoogleCalendarApp
+from universal_mcp.applications.google_mail.app import GmailApp
+from universal_mcp.applications.resend.app import ResendApp
+from universal_mcp.applications.reddit.app import RedditApp
+from universal_mcp.applications.application import Application, APIApplication
+
+def app_from_name(name: str):
+    name = name.lower().strip()
+    name = name.replace(" ", "-")
+    if name == "zenquotes":
+        return ZenQuoteApp
+    elif name == "tavily":
+        return TavilyApp
+    elif name == "github":
+        return GithubApp
+    elif name == "google-calendar":
+        return GoogleCalendarApp
+    elif name == "google-mail":
+        return GmailApp
+    elif name == "resend":
+        return ResendApp
+    elif name == "reddit":
+        return RedditApp
+    else:
+        raise ValueError(f"App {name} not found")
+
+
+__all__ = ["app_from_name", "Application", "APIApplication"]

universal_mcp-0.1.0/src/universal_mcp/applications/application.py

@@ -0,0 +1,101 @@
+from abc import ABC
+from loguru import logger
+from universal_mcp.exceptions import NotAuthorizedError
+from universal_mcp.integrations import Integration
+import httpx
+
+class Application(ABC):
+    """
+    Application is collection of tools that can be used by an agent.
+    """
+    def __init__(self, name: str, **kwargs):
+        self.name = name
+        self.tools = []
+
+    def list_tools(self):
+        return self.tools
+
+class APIApplication(Application):
+    """
+    APIApplication is an application that uses an API to interact with the world.
+    """
+    def __init__(self, name: str, integration: Integration = None, **kwargs):
+        super().__init__(name, **kwargs)
+        self.integration = integration
+
+    def _get_headers(self):
+        return {}
+    
+    def _get(self, url, params=None):
+        try:
+            headers = self._get_headers()
+            response = httpx.get(url, headers=headers, params=params)
+            response.raise_for_status()
+            return response
+        except NotAuthorizedError as e:
+            logger.warning(f"Authorization needed: {e.message}")
+            raise e
+        except Exception as e:
+            logger.error(f"Error getting {url}: {e}")
+            raise e
+
+    
+    def _post(self, url, data, params=None):
+        try:
+            headers = self._get_headers()
+            response = httpx.post(url, headers=headers, json=data, params=params)
+            response.raise_for_status()
+            return response
+        except NotAuthorizedError as e:
+            logger.warning(f"Authorization needed: {e.message}")
+            raise e
+        except httpx.HTTPStatusError as e:
+            if e.response.status_code == 429:
+                return e.response.text or "Rate limit exceeded. Please try again later."
+            else:
+                raise e
+        except Exception as e:
+            logger.error(f"Error posting {url}: {e}")
+            raise e
+
+    def _put(self, url, data, params=None):
+        try:
+            headers = self._get_headers()
+            response = httpx.put(url, headers=headers, json=data, params=params)
+            response.raise_for_status()
+            return response
+        except NotAuthorizedError as e:
+            logger.warning(f"Authorization needed: {e.message}")
+            raise e
+        except Exception as e:
+            logger.error(f"Error posting {url}: {e}")
+            raise e
+
+    def _delete(self, url, params=None):
+        try:
+            headers = self._get_headers()
+            response = httpx.delete(url, headers=headers, params=params)
+            response.raise_for_status()
+            return response
+        except NotAuthorizedError as e:
+            logger.warning(f"Authorization needed: {e.message}")
+            raise e
+        except Exception as e:
+            logger.error(f"Error posting {url}: {e}")
+            raise e
+
+    def _patch(self, url, data, params=None):
+        try:
+            headers = self._get_headers()
+            response = httpx.patch(url, headers=headers, json=data, params=params)
+            response.raise_for_status()
+            return response
+        except NotAuthorizedError as e:
+            logger.warning(f"Authorization needed: {e.message}")
+            raise e
+        except Exception as e:
+            logger.error(f"Error patching {url}: {e}")
+            raise e       
+
+    def validate(self):
+        pass