Skip to main content

​
Usage

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

​
Description

Test an MCP server directly from a repository URL without registry registration or security checks. Useful for quick testing before publishing.
TEST MODE - Bypasses security scanning. Use only for testing your own servers.

​
Options

​
--url
string
required
Repository URL of the MCP server
​
--client
string
required
Target client: vscode, cursor, windsurf, claude, or chatgpt
​
--entrypoint
string
default:"main.py"
Entrypoint file for the server
​
--lang
string
default:"python"
Programming language (python/node)

​
What It Does

1

Skip Registry

Bypasses S3 registry and security scanning
2

Configure Client

Configures client to use Lambda executor with direct repo URL
3

Test Execution

Enables immediate testing without publishing

​
Security Notice

This command skips:
  • Security scanning (SonarQube, Bandit, GitGuardian)
  • Quality checks
  • Registry validation
Use only for testing your own servers before publishing.

​
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