# 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

```bash
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](https://github.com/0x4m4/hexstrike-ai) by 0x4m4