superbox 1.0.0__tar.gz

superbox-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Areeb Ahmed
+
+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.

superbox-1.0.0/PKG-INFO

@@ -0,0 +1,170 @@
+Metadata-Version: 2.4
+Name: superbox
+Version: 1.0.0
+Summary: Discover, deploy, and test MCPs in isolated sandboxes
+Author: SuperBox Team
+License: MIT
+Project-URL: Homepage, https://github.com/areebahmeddd/superbox.ai
+Project-URL: Documentation, https://github.com/areebahmeddd/superbox.ai#readme
+Project-URL: Repository, https://github.com/areebahmeddd/superbox.ai
+Project-URL: Issues, https://github.com/areebahmeddd/superbox.ai/issues
+Keywords: mcp,fastapi,gin,docker,cli,security,registry
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: python-dotenv
+Requires-Dist: boto3
+Requires-Dist: pydantic[email]
+Requires-Dist: websockets
+Provides-Extra: cli
+Requires-Dist: click; extra == "cli"
+Requires-Dist: requests; extra == "cli"
+Requires-Dist: bandit; extra == "cli"
+Requires-Dist: ggshield; extra == "cli"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: moto[s3]; extra == "dev"
+Requires-Dist: freezegun; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Provides-Extra: all
+Requires-Dist: superbox[cli,dev]; extra == "all"
+Dynamic: license-file
+
+<div align="center">
+
+```text
+                          _                      _
+                         | |                    (_)
+___ _   _ _ __   ___ _ __| |__   _____  __  __ _ _
+/ __| | | | '_ \ / _ \ '__| '_ \ / _ \ \/ / / _` | |
+\__ \ |_| | |_) |  __/ |  | |_) | (_) >  < | (_| | |
+|___/\__,_| .__/ \___|_|  |_.__/ \___/_/\_(_)__,_|_|
+         | |
+         |_|
+```
+
+</div>
+
+# 🧰 SuperBox
+
+**SuperBox** (inspired by [Docker Hub](https://hub.docker.com)) helps you discover, deploy, and test MCPs in isolated sandboxes. It includes:
+
+- A Python (Click) CLI to initialize metadata, run security scans, push to a registry (S3), search, and configure popular AI clients (VS Code, Cursor, Windsurf, Claude, ChatGPT)
+- A Golang (Gin) backend to list/get/create MCP servers with optional pricing and security reports
+- An AWS Lambda worker that executes MCP servers on demand directly from their Git repositories
+
+Why this project:
+
+- There's no centralized MCP registry to discover all MCPs, and many lack clear usage docs.
+- MCPs on our platform pass a 5‑step security/quality check (SonarQube, Bandit, GitGuardian) to reduce vulnerabilities and promote best practices.
+- Unlike MCPs that run locally on your machine, MCP servers here execute in sandboxed environments and return responses securely.
+
+## Key Features
+
+- **Central MCP Registry**: S3‑backed registry with per‑server JSON for easy discovery and portability.
+- **Sandboxed Execution**: MCP servers run in isolated environments and return responses securely.
+- **Security Pipeline (5‑step)**: SonarQube, Bandit, and GitGuardian checks with a unified report.
+- **One‑Command Publish**: `superbox push` scans, discovers tools, and uploads a unified record to S3.
+- **Client Auto‑Config**: `superbox pull --client cursor|vscode|...` writes correct MCP config pointing to the Lambda endpoint.
+- **Terminal Runner**: `superbox run --name <server>` starts an interactive prompt against the Lambda executor.
+- **CloudWatch Logs**: `superbox logs --name <server>` fetches execution logs from AWS with real-time follow support.
+- **Tool Discovery**: Regex‑based discovery across Python code and optional Node `package.json` definitions.
+
+> **Note:** The Lambda executor currently supports Python MCP servers.
+
+## 📚 Documentation
+
+**For complete documentation, setup guides, API references, and CLI usage:**
+
+🔗 **[https://superbox.1mindlabs.org/docs](https://acm-aa28ebf6.mintlify.app)**
+
+## 🗂️ Project Structure
+
+```text
+.
+├── docs/                       # Documentation (INSTALL.md)
+├── src/
+│   └── superbox/
+│       ├── cli/                # CLI: init, auth, push, pull, run, search, inspect, test, logs
+│       │   ├── commands/       # CLI subcommands
+│       │   └── scanners/       # SonarCloud, Bandit, ggshield, tool-discovery
+│       ├── server/             # Golang (Gin) app + handlers
+│       │   ├── handlers/       # servers, payment, auth, health
+│       │   ├── models/         # Request/response types
+│       │   ├── helpers/        # Python S3 helper
+│       │   └── templates/      # Landing page
+│       ├── shared/             # Config, models, S3 utils
+│       └── aws/                # AWS Lambda & WebSocket proxy
+│           ├── lambda.py       # Lambda handler (WebSocket executor)
+│           └── proxy.py        # Local stdio-WebSocket bridge
+├── pyproject.toml              # Project metadata & dependencies
+├── Dockerfile                  # Server container
+├── docker-compose.yaml         # Optional local stack
+└── tests/                      # PyTests
+```
+
+## 🌐 API Reference
+
+The HTTP API provides endpoints for server management, authentication, and payments.
+
+For complete API documentation, see [https://superbox.1mindlabs.org/docs/api](https://acm-aa28ebf6.mintlify.app/api)
+
+## 🔧 CLI Overview
+
+The SuperBox CLI provides commands for authentication, server management, and testing:
+
+**Authentication:**
+
+- `superbox auth register` – Register a new account
+- `superbox auth login` – Log in (email/Google/GitHub)
+- `superbox auth logout` – Log out
+- `superbox auth status` – Check authentication status
+- `superbox auth refresh` – Refresh authentication token
+
+**Server Management:**
+
+- `superbox init` – Initialize a new MCP server project
+- `superbox push` – Publish server to registry
+- `superbox pull` – Download and configure server for AI clients
+- `superbox search` – Search for servers in registry
+- `superbox inspect` – View server details and security report
+- `superbox test` – Test server directly from repository (without registry)
+
+**Execution & Monitoring:**
+
+- `superbox run` – Run server in interactive mode
+- `superbox logs` – View server execution logs
+
+For detailed CLI documentation and usage examples, see [https://superbox.1mindlabs.org/docs/cli](https://acm-aa28ebf6.mintlify.app/cli)
+
+## 📦 Installation
+
+See [docs/INSTALL.md](docs/INSTALL.md) for complete installation instructions.
+
+## 📄 License
+
+This project is licensed under the [MIT License](LICENSE).
+
+## 👥 Authors
+
+**Core Contributors:**
+
+- [Areeb Ahmed](https://github.com/areebahmeddd)
+- [Amartya Anand](https://github.com/amarr07)
+- [Arush Verma](https://github.com/arush3218)
+- [Devansh Aryan](https://github.com/devansharyan123)
+
+**Acknowledgments:**
+
+- [Shivansh Karan](https://github.com/spacetesla)
+- [Rishi Chirchi](https://github.com/rishichirchi)
+- [Avantika Kesarwani](https://github.com/avii09)

superbox-1.0.0/README.md

@@ -0,0 +1,129 @@
+<div align="center">
+
+```text
+                          _                      _
+                         | |                    (_)
+___ _   _ _ __   ___ _ __| |__   _____  __  __ _ _
+/ __| | | | '_ \ / _ \ '__| '_ \ / _ \ \/ / / _` | |
+\__ \ |_| | |_) |  __/ |  | |_) | (_) >  < | (_| | |
+|___/\__,_| .__/ \___|_|  |_.__/ \___/_/\_(_)__,_|_|
+         | |
+         |_|
+```
+
+</div>
+
+# 🧰 SuperBox
+
+**SuperBox** (inspired by [Docker Hub](https://hub.docker.com)) helps you discover, deploy, and test MCPs in isolated sandboxes. It includes:
+
+- A Python (Click) CLI to initialize metadata, run security scans, push to a registry (S3), search, and configure popular AI clients (VS Code, Cursor, Windsurf, Claude, ChatGPT)
+- A Golang (Gin) backend to list/get/create MCP servers with optional pricing and security reports
+- An AWS Lambda worker that executes MCP servers on demand directly from their Git repositories
+
+Why this project:
+
+- There's no centralized MCP registry to discover all MCPs, and many lack clear usage docs.
+- MCPs on our platform pass a 5‑step security/quality check (SonarQube, Bandit, GitGuardian) to reduce vulnerabilities and promote best practices.
+- Unlike MCPs that run locally on your machine, MCP servers here execute in sandboxed environments and return responses securely.
+
+## Key Features
+
+- **Central MCP Registry**: S3‑backed registry with per‑server JSON for easy discovery and portability.
+- **Sandboxed Execution**: MCP servers run in isolated environments and return responses securely.
+- **Security Pipeline (5‑step)**: SonarQube, Bandit, and GitGuardian checks with a unified report.
+- **One‑Command Publish**: `superbox push` scans, discovers tools, and uploads a unified record to S3.
+- **Client Auto‑Config**: `superbox pull --client cursor|vscode|...` writes correct MCP config pointing to the Lambda endpoint.
+- **Terminal Runner**: `superbox run --name <server>` starts an interactive prompt against the Lambda executor.
+- **CloudWatch Logs**: `superbox logs --name <server>` fetches execution logs from AWS with real-time follow support.
+- **Tool Discovery**: Regex‑based discovery across Python code and optional Node `package.json` definitions.
+
+> **Note:** The Lambda executor currently supports Python MCP servers.
+
+## 📚 Documentation
+
+**For complete documentation, setup guides, API references, and CLI usage:**
+
+🔗 **[https://superbox.1mindlabs.org/docs](https://acm-aa28ebf6.mintlify.app)**
+
+## 🗂️ Project Structure
+
+```text
+.
+├── docs/                       # Documentation (INSTALL.md)
+├── src/
+│   └── superbox/
+│       ├── cli/                # CLI: init, auth, push, pull, run, search, inspect, test, logs
+│       │   ├── commands/       # CLI subcommands
+│       │   └── scanners/       # SonarCloud, Bandit, ggshield, tool-discovery
+│       ├── server/             # Golang (Gin) app + handlers
+│       │   ├── handlers/       # servers, payment, auth, health
+│       │   ├── models/         # Request/response types
+│       │   ├── helpers/        # Python S3 helper
+│       │   └── templates/      # Landing page
+│       ├── shared/             # Config, models, S3 utils
+│       └── aws/                # AWS Lambda & WebSocket proxy
+│           ├── lambda.py       # Lambda handler (WebSocket executor)
+│           └── proxy.py        # Local stdio-WebSocket bridge
+├── pyproject.toml              # Project metadata & dependencies
+├── Dockerfile                  # Server container
+├── docker-compose.yaml         # Optional local stack
+└── tests/                      # PyTests
+```
+
+## 🌐 API Reference
+
+The HTTP API provides endpoints for server management, authentication, and payments.
+
+For complete API documentation, see [https://superbox.1mindlabs.org/docs/api](https://acm-aa28ebf6.mintlify.app/api)
+
+## 🔧 CLI Overview
+
+The SuperBox CLI provides commands for authentication, server management, and testing:
+
+**Authentication:**
+
+- `superbox auth register` – Register a new account
+- `superbox auth login` – Log in (email/Google/GitHub)
+- `superbox auth logout` – Log out
+- `superbox auth status` – Check authentication status
+- `superbox auth refresh` – Refresh authentication token
+
+**Server Management:**
+
+- `superbox init` – Initialize a new MCP server project
+- `superbox push` – Publish server to registry
+- `superbox pull` – Download and configure server for AI clients
+- `superbox search` – Search for servers in registry
+- `superbox inspect` – View server details and security report
+- `superbox test` – Test server directly from repository (without registry)
+
+**Execution & Monitoring:**
+
+- `superbox run` – Run server in interactive mode
+- `superbox logs` – View server execution logs
+
+For detailed CLI documentation and usage examples, see [https://superbox.1mindlabs.org/docs/cli](https://acm-aa28ebf6.mintlify.app/cli)
+
+## 📦 Installation
+
+See [docs/INSTALL.md](docs/INSTALL.md) for complete installation instructions.
+
+## 📄 License
+
+This project is licensed under the [MIT License](LICENSE).
+
+## 👥 Authors
+
+**Core Contributors:**
+
+- [Areeb Ahmed](https://github.com/areebahmeddd)
+- [Amartya Anand](https://github.com/amarr07)
+- [Arush Verma](https://github.com/arush3218)
+- [Devansh Aryan](https://github.com/devansharyan123)
+
+**Acknowledgments:**
+
+- [Shivansh Karan](https://github.com/spacetesla)
+- [Rishi Chirchi](https://github.com/rishichirchi)
+- [Avantika Kesarwani](https://github.com/avii09)

superbox-1.0.0/pyproject.toml

@@ -0,0 +1,77 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "superbox"
+version = "1.0.0"
+description = "Discover, deploy, and test MCPs in isolated sandboxes"
+readme = "README.md"
+requires-python = ">=3.11"
+license = {text = "MIT"}
+authors = [
+    {name = "SuperBox Team"}
+]
+keywords = ["mcp", "fastapi", "gin", "docker", "cli", "security", "registry"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+dependencies = [
+    "python-dotenv",
+    "boto3",
+    "pydantic[email]",
+    "websockets",
+]
+
+[project.optional-dependencies]
+cli = [
+    "click",
+    "requests",
+    "bandit",
+    "ggshield",
+]
+dev = [
+    "pytest",
+    "pytest-cov",
+    "pytest-asyncio",
+    "moto[s3]",
+    "freezegun",
+    "ruff",
+    "pre-commit",
+]
+all = [
+    "superbox[cli,dev]"
+]
+
+[project.scripts]
+superbox = "superbox.cli.main:main"
+
+[project.urls]
+Homepage = "https://github.com/areebahmeddd/superbox.ai"
+Documentation = "https://github.com/areebahmeddd/superbox.ai#readme"
+Repository = "https://github.com/areebahmeddd/superbox.ai"
+Issues = "https://github.com/areebahmeddd/superbox.ai/issues"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["superbox*"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+asyncio_mode = "auto"

superbox-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

superbox-1.0.0/src/superbox/__init__.py

@@ -0,0 +1,4 @@
+"""SuperBox - MCP server registry and CLI."""
+
+__version__ = "1.0.0"
+__author__ = "SuperBox Team"

superbox-1.0.0/src/superbox/aws/__init__.py

@@ -0,0 +1 @@
+"""AWS integration components for SuperBox."""

superbox-1.0.0/src/superbox/aws/__main__.py

@@ -0,0 +1,4 @@
+from superbox.aws.proxy import main
+
+if __name__ == "__main__":
+    main()