Skip to main content

​
Usage

superbox test --url URL --client CLIENT [--entrypoint FILE] [--lang LANGUAGE]

​
Description

Test an MCP server directly from a GitHub repository URL without registry registration or security checks. Perfect for rapid development and testing before publishing to the platform.
TEST MODE - Bypasses security scanning and S3 registration. Use only for testing your own servers during development.

​
Options

​
--url
string
required
GitHub repository URL of the MCP server
​
--client
string
required
Target AI client: vscode, cursor, windsurf, claude, or chatgpt
​
--entrypoint
string
default:"main.py"
Entrypoint file for the server
​
--lang
string
default:"python"
Programming language (currently supports Python)

​
How It Works

1

Skip Registry

Bypasses S3 registry lookup and security scanning pipeline
2

Configure Client

Writes MCP config with test mode WebSocket URL pointing directly to your repo
3

Lambda Clones Repo

Lambda executor clones your repo from GitHub on-demand (no S3 storage)
4

Test in Client

Use the server immediately in your AI client (appears as your-repo-test)

​
Architecture

The test mode uses the same WebSocket infrastructure as production but tells Lambda to clone directly from your repo URL instead of fetching from S3.

​
Security Notice

This command skips:
  • Security scanning (SonarQube, Bandit, GitGuardian)
  • Quality checks
  • Registry validation
Only test servers you trust or own.

​
Examples

superbox test --url https://github.com/user/my-mcp --client cursor

​
Example Output

$ superbox test --url https://github.com/user/my-mcp --client cursor
⚠️  TEST MODE - No Security Checks
This server is being tested directly and has NOT gone through:
  • Security scanning (SonarQube, Bandit, GitGuardian)
  • Quality checks
  • Registry validation

✓ Configuration written to ~/.cursor/mcp.json

Ready to test in Cursor!

​
Next Steps

Push Server

Publish after tests pass

Run Locally

Test interactively