语音控制Kali Linux代理

一款运行在MentraOS智能眼镜上的语音控制AI代理,可通过自然语言远程控制Kali Linux机器,支持Claude和Ollama后端。

  • by matt-desmarais
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 matt-desmarais/VoxRecon

使用说明

Kali——Kali Linux的MentraOS语音代理

一个运行在 MentraOS智能眼镜 并允许您控制遥控器 Kali Linux 机器使用自然语言。支持两者 克劳德 (人类学)和 奥拉玛 (本地LLM)后端并通过Kali REST API服务器执行命令。

特性

  • 语音命令被转录并路由到克劳德或当地Ollama模型
  • 内置Kali工具: nmap, nikto, gobuster, dirb, hydra, john, sqlmap, metasploit,以及任意shell命令
  • 实时网络视图仪表板(切换麦克风、静音TTS、切换AI后端、通过键盘运行命令)
  • 破坏性/危险工具调用确认门
  • 回声抑制(忽略助手刚才说的话)
  • Kali服务器和AI后端的自动健康检查

建筑

MentraOS Glasses
  └── Voice → AppSession (this app)
                ├── Claude API  (default)
                └── Ollama API  (optional local LLM)
                      └── Tool calls → Kali REST API server
                                         (reachable via Tailscale)

Kali REST API服务器在您的Kali Linux机箱上运行(请参阅 kali mcp服务器 或者滚自己的 POST /api/command 和 POST /api/tools/:tool).

与Tailscale建立联系

此应用程序旨在通过 尾鳞 私有网状网络。Tailscale为每个设备提供稳定的私有IP(100.x.x.x)它可以跨NAT、防火墙和不同的物理位置工作,不需要端口转发或VPN配置。

为什么选择Tailscale?

  • MentraOS应用服务器和Kali盒子可以在完全不同的网络上(家庭实验室、VPS、云实例),并且仍然可以安全地相互通信。
  • 尾标IP稳定,所以 MCP_URL 即使Kali机器的公共IP发生变化,也保持一致。

设置:

  1. 在运行此应用程序的机器和Kali Linux机器上安装Tailscale: tailscale.com/下载
  2. 将两台设备验证到同一个Tailscale帐户(tailscale up)
  3. 查找Kali机器的Tailscale IP: tailscale ip -4
  4. 集 MCP_URL=http://<tailscale-ip>:5000 在你的 .env

尾标是可选的——任何可访问的IP/主机名都适用 MCP_URL.

先决条件

  • 包子 运行时
  • A. Mentra操作系统 开发者帐户和API密钥
  • 运行配套REST API服务器的Kali Linux机器
  • 尾鳞 在两台机器上(建议用于安全远程访问)
  • 人类API密钥 或 Ollama实例(或两者)

设置

git clone https://github.com/your-org/kali-mentraos.git
cd kali-mentraos
cp .env.example .env
# Fill in .env with your credentials and server IPs
bun install
bun run index.ts

环境变量

变量 必填 默认 描述
MENTRAOS_API_KEY 是 - MentraOS开发者API密钥
ANTHROPIC_API_KEY 如果使用Claude - Anthropic API密钥
PORT 是的 3000 应用服务器端口
PACKAGE_NAME 是的 com.you.kali MentraOS应用程序包名称
MCP_URL 是的 http://YOUR_KALI_IP:5000 Kali REST API基础URL
OLLAMA_BASE_URL 如果使用Olama http://YOUR_OLLAMA_IP:11434/v1 Ollama API基础URL
OLLAMA_MODEL 没有 llama3.1:8b 默认Olama型号

网页视图

打开 http://localhost:3001 (或者别的什么 PORT+1 从MentraOS网络视图URL解析为)以访问控制面板。您可以键入命令、在Claude/Ollama之间切换、静音TTS、暂停麦克风和查看会话日志。

免责声明

此工具用于 授权渗透测试、CTF竞赛和安全研究 只有。不要在您不拥有或没有明确书面许可进行测试的系统上使用它。