mcp_ngrok — HexStrike AI + Ngrok (One Command)

Clone → install deps → run one Python file.
Public URL via Ngrok. Core server files auto-download if missing.

Quick Start

git clone https://github.com/veteranchat/mcp_ngrok.git
cd mcp_ngrok

python3 -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate
pip install -r requirements.txt

# Token: https://dashboard.ngrok.com/get-started/your-authtoken
python3 launch_hexstrike.py

launch_hexstrike.py will:

1. Download hexstrike_server.py + hexstrike_mcp.py (if not present)
2. Start the API server on port 8888
3. Open an Ngrok HTTPS tunnel
4. Update hexstrike-ai-mcp.json with the public URL

File importance

File	Important?	Notes
launch_hexstrike.py	YES	Main entry — only file you run
hexstrike_server.py	YES	Flask API (auto-downloaded ~735KB)
hexstrike_mcp.py	YES	MCP bridge (auto-downloaded ~218KB)
requirements.txt	YES	Python dependencies
hexstrike-ai-mcp.json	useful	MCP client config (auto-updated)
setup_files.py	optional	Manual download helper
ngrok_config.json	local only	Created on first run — do not commit
assets/*	no	Logos only
*.log	no	Runtime logs
run_hexstrike_cloudflare.py	no	Old Cloudflare method

Endpoints

Item	Value
Local	http://127.0.0.1:8888
Health	GET /health
Public	printed by launcher

Security

• Never commit Ngrok tokens
• Free Ngrok URLs are public — treat the API as internet-facing
• Rotate token if leaked

License

MIT — based on HexStrike AI by 0x4m4