A high-performance HTTP server written in C that dynamically executes Python CGI scripts, serves static files, and supports auto-deployment via Git polling.
scorpiox-server is the backbone of code.scorpiox.net and ScorpioX Code's web infrastructure.
It clones a Git repository containing Python CGI scripts, maps URL routes to .py files,
and executes them on every request — outputting HTML directly via stdout. The server watches the
upstream repo on a configurable polling interval and automatically pulls new commits, enabling
zero-downtime continuous deployment. It also serves static assets (CSS, JS, images) and supports
MCP (Model Context Protocol) mode for AI agent integration.
| Flag | Short | Description | Takes Value |
|---|---|---|---|
--help |
-h |
Display help information and available options | Yes |
--repo |
-r |
Git repository URL to clone and serve (auto-deploys .py scripts) | Yes |
--branch |
-b |
Git branch to checkout (default: main) | Yes |
--poll |
— |
Polling interval in seconds to check for upstream changes and auto-pull | Yes |
--mcp |
— |
Enable MCP (Model Context Protocol) server mode for AI tool integration | Yes |
--name |
— |
Set a custom server instance name for logging and identification | Yes |
Basic: Serve a Git repository on default port
Specify branch and custom server name
Enable auto-polling for continuous deployment (every 30s)
MCP mode for AI agent tool serving
Production deployment with all options
How CGI routing works
Display help