QuantWarden Monorepo

This repository now contains multiple APIs that can be run together.

Services

• OneForAll subdomain API
• Subfinder API
• PySSL API
• Nmap Security Intelligence API
• OpenSSL TLS Profile API

Default ports

• OneForAll API: 8002
• Subfinder API: 8085
• PySSL API: 8000
• Nmap API: 8010
• OpenSSL API: 8020

Quick start with one command

Run from monorepo root:

python3 start_monorepo_servers.py

What this does:

• Starts OneForAll API
• Starts Subfinder API
• Starts PySSL API
• Starts Nmap API
• Starts OpenSSL API
• Detects busy ports and automatically reassigns to free ports
• Injects runtime env vars for Subfinder so it can reach OneForAll

Press Ctrl+C to stop all services.

Interactive setup mode

Use setup mode to choose ports interactively and optionally persist env values:

python3 start_monorepo_servers.py --setup

Setup mode asks:

• OneForAll port
• Subfinder port
• PySSL port
• Nmap port
• OpenSSL port
• Whether to persist Subfinder env settings into subfinder-api/.env

Persist env updates into subfinder-api/.env

If you want the script to save the resolved URL and listen address:

python3 start_monorepo_servers.py --persist-env

Keys written or updated in subfinder-api/.env:

• ONEFORALL_API_URL
• SUBFINDER_API_ADDR

If you do not use this flag, env values are applied only at runtime for that launch.

Manual startup commands

If you prefer to run each service yourself:

1) Start OneForAll API

cd one-for-all-subdomains
python3 run_api.py --port 8002

2) Start Subfinder API with OneForAll integration

cd subfinder-api
ONEFORALL_API_URL=http://127.0.0.1:8002 SUBFINDER_API_ADDR=:8085 go run .

3) Start PySSL API on a non-conflicting port

cd pyssl-api
python3 -m uvicorn main:app --host 0.0.0.0 --port 8001

4) Start Nmap API on a non-conflicting port

cd nmap-api
python3 -m uvicorn main:app --host 0.0.0.0 --port 8010 --reload

5) Start OpenSSL API on a non-conflicting port

cd openssl-api
python3 -m uvicorn main:app --host 0.0.0.0 --port 8020 --reload

Optional explicit port arguments

You can pass explicit preferred ports to launcher:

python3 start_monorepo_servers.py --oneforall-port 8002 --subfinder-port 8085 --pyssl-port 8000

Include Nmap explicitly if desired:

python3 start_monorepo_servers.py --oneforall-port 8002 --subfinder-port 8085 --pyssl-port 8000 --nmap-port 8010

Include OpenSSL explicitly if desired:

python3 start_monorepo_servers.py --oneforall-port 8002 --subfinder-port 8085 --pyssl-port 8000 --nmap-port 8010 --openssl-port 8020

If a preferred port is busy, the launcher logs a warning and picks the next available port.

Logs and colors

The launcher prints colorized logs:

• Green: info
• Yellow: warnings
• Red: errors
• Colored prefixes for each service stream

Disable colors by setting NO_COLOR=1.

Python virtual environments

Yes, the launcher now handles service-specific Python virtualenvs.

Resolution order per Python service:

1. Explicit CLI override (if provided)
2. Service local .venv/bin/python
3. Service local venv/bin/python
4. Fallback to --python-cmd (default python3)

Override examples:

python3 start_monorepo_servers.py \
	--oneforall-python /abs/path/to/oneforall/.venv/bin/python \
	--pyssl-python /abs/path/to/pyssl/venv/bin/python \
	--nmap-python /abs/path/to/nmap-api/.venv/bin/python \
	--openssl-python /abs/path/to/openssl-api/.venv/bin/python

This keeps dependencies isolated between one-for-all-subdomains, pyssl-api, nmap-api, and openssl-api while still allowing a fallback when no venv exists.

Ubuntu VM Deployment (Docker)

For Azure Ubuntu VMs, the easiest production-style deployment is Docker Compose.

1) Install Docker Engine + Compose plugin

sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

echo \
	"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
	$(. /etc/os-release && echo \"$VERSION_CODENAME\") stable" | \
	sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo usermod -aG docker $USER

Log out/in once after usermod.

2) Run the stack

From monorepo root:

cp .env.docker.example .env
docker compose up -d --build

This starts:

• oneforall-api (8002)
• subfinder-api (8085)
• pyssl-api (8000)
• nmap-api (8010)
• openssl-api (8020)
• mcp-monorepo-server (internal MCP bridge service)

3) Check status and logs

docker compose ps
docker compose logs -f nmap-api

4) Stop the stack

docker compose down

Notes:

• Service Dockerfiles are in each service directory.
• nmap-api container includes the nmap CLI package.
• Host ports are configurable via .env using .env.docker.example as the template.

MCP Server For AI Agents

The monorepo now includes an MCP server so external AI agents can call backend APIs through a single tool interface.

Location:

• mcp-monorepo-server/

Quick start:

cd mcp-monorepo-server
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python server.py

Client config templates:

• Claude Desktop / Cursor templates: mcp-monorepo-server/config-examples/
• VS Code workspace MCP config: .vscode/mcp.json

Common tools exposed by this MCP server:

• nmap_security_intelligence
• nmap_ethical_scan
• openssl_profile
• pyssl_analysis
• subfinder_combined
• subfinder_only
• assetfinder_only
• monorepo_api_request (generic request wrapper)

By default the server targets localhost service ports from this monorepo launcher. Override with env vars if needed:

• ONEFORALL_API_URL
• SUBFINDER_API_URL
• PYSSL_API_URL
• NMAP_API_URL
• OPENSSL_API_URL