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:
- Download
hexstrike_server.py+hexstrike_mcp.py(if not present) - Start the API server on port 8888
- Open an Ngrok HTTPS tunnel
- Update
hexstrike-ai-mcp.jsonwith 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
