HexStrike AI MCP Agents v6.0

MCP server untuk agentic cybersecurity - 150+ security tools terintegrasi, terhubung ke Claude AI via ngrok tunnel.

Prasyarat

ngrok tidak perlu install manual - launcher otomatis download dan extract.

Related MCP server: Neo MCP

Cara Pakai Step by Step

Step 1 - Clone Repository

git clone https://github.com/burstbullet666-bit/fix222.git
cd fix222

Step 2 - Buat Virtual Environment

python3 -m venv venv
source venv/bin/activate

Tanda berhasil: prompt terminal berubah jadi (venv) root@mazzdaffa:~$

Untuk nonaktifkan venv setelah selesai:

deactivate

Step 3 - Install Dependencies

pip install -r requirements.txt

Butuh 5-15 menit karena ada package besar seperti angr, pwntools, mitmproxy.

Kalau ada yang gagal, install bertahap:

# Core (wajib)
pip install flask requests aiohttp mcp psutil tqdm

# Web & browser automation
pip install beautifulsoup4 selenium webdriver-manager

# Security tools (opsional, skip jika error)
pip install mitmproxy pwntools angr bcrypt

Step 4 - Isi ngrok Authtoken

1. Buka https://dashboard.ngrok.com/get-started/your-authtoken

2. Daftar gratis dan copy authtoken kamu

3. Edit file ngrok_config.json:

{
  "authtoken": "ISI_TOKEN_NGROK_KAMU_DI_SINI",
  "region": "ap"
}

Region ap = Asia Pacific (paling cepat untuk Indonesia). Opsi lain: us, eu, au, jp, in, sa

Step 5 - Jalankan HexStrike

python3 launch_hexstrike_v5.py

Pertama kali jalan, launcher otomatis:

• Cek port tersedia (auto-rotate jika bentrok)

• Download ngrok jika belum ada (ada progress bar)

• Extract dan chmod +x ngrok otomatis

• Start HexStrike REST API server di port 9888

• Start MCP server di port 9889

• Aktifkan ngrok tunnel dan dapat URL publik

Output jika berhasil:

=========================================================
  HexStrike AI Launcher v5.0 - Smart Port Manager
=========================================================

[OK]    HexStrike Server running (PID: 12345) port 9888
[OK]    HexStrike MCP listening port 9889
[OK]    Ngrok active -> https://abcd-1234-5678.ngrok-free.app
[*]     Connector URL disimpan ke hexstrike-ai-mcp.json

Step 6 - Hubungkan ke Claude AI

1. Buka file hexstrike-ai-mcp.json yang terbuat otomatis

2. Copy nilai connector_url:

{
  "connector_url": "https://abcd-1234-5678.ngrok-free.app/mcp"
}

3. Buka Claude.ai klik foto profil klik Settings

4. Pilih tab Connectors klik Add custom connector

5. Paste URL connector klik Connect

6. Selesai! Claude sekarang bisa pakai 150+ HexStrike security tools

Penggunaan Selanjutnya (Setelah Setup Awal)

Cukup jalankan ini setiap kali mau pakai:

cd fix222
source venv/bin/activate
python3 launch_hexstrike_v5.py

Penting: URL ngrok berubah setiap restart. Update connector URL di Claude setiap ada URL baru dari hexstrike-ai-mcp.json.

Troubleshooting

Error: No module named mcp.server.fastmcp

mcp SDK v2.x sudah rename FastMCP ke MCPServer. File repo ini sudah di-fix.

pip install mcp>=2.0.0

Port sudah dipakai

Launcher auto-rotate. Atau pilih custom:

python3 launch_hexstrike_v5.py
# Pilih menu 3 untuk custom port

ngrok gagal connect atau timeout

Cek authtoken di ngrok_config.json sudah benar dan aktif.

Permission denied ngrok

chmod +x ngrok

pip install error di angr atau pwntools

sudo apt install -y python3-dev build-essential libffi-dev
pip install pwntools angr

Venv tidak aktif setelah buka terminal baru

cd fix222
source venv/bin/activate

Struktur File

fix222/
|-- hexstrike_server.py      # Flask REST API server (port 9888)
|-- hexstrike_mcp.py         # MCP server 150+ security tools (port 9889)
|-- launch_hexstrike_v5.py   # MAIN LAUNCHER - gunakan ini
|-- launch_hexstrike.py      # Launcher versi lama (backup)
|-- requirements.txt         # Python dependencies
|-- hexstrike-ai-mcp.json    # Connector URL Claude (auto-generate saat run)
|-- ngrok_config.json        # ISI AUTHTOKEN NGROK KAMU DI SINI
|-- hexstrike_ports.json     # Port aktif yang dipakai (auto-generate)

Changelog v6.0

Fix mcp SDK v2.x

Auto-download ngrok

• Download .zip dari Equinox CDN secara otomatis

• Fallback ke .tgz jika .zip gagal

• Deteksi .tgz lokal yang sudah ada (tidak download ulang)

• Progress bar via tqdm

• chmod +x dan tambah ke PATH otomatis

Lisensi

MIT License