使用说明

己糖罢工+村民爱MCP

AI-Driven Cybersecurity Automation (HexStrike + Villager AI) disponibilizado como servidores MCP.

Empresa: CSOFTWARE
Autor: Leonardo Marinho Poeiras
Data: 29/03/2026

MIT | Python | Docker

描述

该项目集成了一个自动化和编排环境（Villager AI）与一个工具库（HexStrike），并将所有内容提供为 MCP 服务器 让LLM（例如：AI光标）根据目标的复杂性选择和运行适当的工具。

其目的是减少运营摩擦，提高可追溯性（健康终端+日志），并启用安全的混合流（在授权和受控环境中使用时）。

简介：HexStrike/村民AI

HexStrike AI

大量的安全工具集合（扫描，列表，实用程序和典型的pentest例程）。
非常适合快速执行和准时操作时，目标是相对简单的。

村民AI

编排层：分解任务，协调行动，并使用LLM推理来规划和验证结果。
更适合复杂、多阶段、需要规划和链接的目标。

MCP 角色

MCP（模型上下文协议）作为客户端（例如光标）和展示工具的服务器之间的标准桥梁。

此工程通常有两个服务器：

villager-proper： Villager AI MCP 服务器（编排）
hexstrike-aiHexStrike MCP 服务器（直接工具）

客户（LLM）可以选择混合工具。

官方参考资料

HexStrike AI（官方仓库）：https://github.com/0x4m4/hexstrike-ai
Villager AI（官方仓库/上游）：https://github.com/gregcmartin/villager
开放式法律（加拿大文献）：https://docs.openclaw.ai/channels

范围和责任

该框架旨在 教育目的 e 授权测试 （受控的环境和明确许可）。

在任何实际情况下使用之前：

获得正式授权（范围、目标/域、规则、时间限制）
使用隔离环境（实验室、舞台、容器）
遵守法律、内部政策和合规性

一般建筑

高级签证：

客户端（例如：光标）调用MCP暴露的工具。
服务器 villager-proper 通过 MCP 客户端对流程进行编排并将执行委托给外部组件（例如 Kali 驱动程序、浏览器）。
服务器 hexstrike-ai 执行程序并将结果返回给客户端。
健康端点有助于检查连接性和准备状态。

要求

WSL+docker桌面观察器

Ative integracao do WSL no Docker Desktop（例如：发行版 Ubuntu).
没有WSL，行李箱 docker ps.

初始配置

这种干旱实际上描述了从零开始的道路。

1）准备非WSL环境

无WSL：

cd ~
mkdir -p projetos/mcp
cd projetos/mcp

2）克隆仓库并安装依赖关系

git clone https://github.com/Yenn503/villager-ai-hexstrike-integration.git
cd villager-ai-hexstrike-integration
./scripts/setup.sh

哦 setup.sh 执行者：

安装系统软件包
设置环境Python（venv）
准备司机/集装箱
服务启动（根据项目结构）

3）设置 .env

工程正在等待一个文件 .env 存储库的根。

cp .env.example .env

然后调整：

LLM （LLM_PROVIDER)
提供商密钥/地址（如适用）
URLs/portas dos servicos（村民e HexStrike）
权限选项（ALLOW_*（谨慎）

4）提升村民服务

./scripts/start_villager_proper.sh

5）有效终点健康状况不佳（无WSL）

检查示例：

curl http://127.0.0.1:37695/health
curl http://127.0.0.1:25989/health
curl http://127.0.0.1:1611/health
curl http://127.0.0.1:8080/health

O端点do hexstrike-ai 这取决于HexStrike服务器是如何启动的，但在MCP流中通常是这样的：

curl http://127.0.0.1:8888/health

环境变量（.env）

主要变量

配置时 .env考虑：

LLM_PROVIDER: deepseek, openai 或 ollama
DEEPSEEK_API_KEY / DEEPSEEK_BASE_URL：当 LLM_PROVIDER=deepseek
OPENAI_API_KEY：当 LLM_PROVIDER=openai
OLLAMA_BASE_URL e OLLAMA_MODEL：当 LLM_PROVIDER=ollama
VILLAGER_HOST / VILLAGER_PORT：仆人村民
HEXSTRIKE_BASE_URL运行时可访问的 HexStrike 服务器的 url/端口
MCP_CLIENT_BASE_URL：端点做组件内部MCP客户端
ALLOW_SHELL, ALLOW_APT, ALLOW_WRITE, ALLOW_BUILD：权限启用
LOG_LEVEL, LOG_FILE：日志

示例块（本地查看器）

LLM_PROVIDER=ollama
OLLAMA_BASE_URL=http://localhost:11434
OLLAMA_MODEL=deepseek-r1

模块示例（DeepSeek API）

LLM_PROVIDER=deepseek
DEEPSEEK_API_KEY=SEU_TOKEN_AQUI
DEEPSEEK_BASE_URL=https://api.deepseek.com

MCP 光标配置

配置文件

一般来说，cursor使用 mcp.json 或 mcp_servers.json通常在：

C:\Users\<usuario>\.cursor\mcp.json

JSON 必须包含 mcpServers 通用域名格式：

villager-proper
hexstrike-ai

重要规则

顺序： villager-proper 第一
对于WSL，使用 wsl.exe e路径Linux绝对版
确保 MCP 中的 HexStrike 端口（--server ...）对应于 HEXSTRIKE_BASE_URL

模板（WSL）

编辑模板以反映您的路径和发行版名称：

{
  "mcpServers": {
    "villager-proper": {
      "command": "wsl.exe",
      "args": [
        "-d",
        "Ubuntu",
        "-e",
        "/home/leona/projetos/villager-ai-hexstrike-integration/villager-venv-new/bin/python3",
        "/home/leona/projetos/villager-ai-hexstrike-integration/src/villager_ai/mcp/villager_proper_mcp.py",
        "--debug"
      ],
      "description": "Villager AI Framework (WSL Ubuntu)",
      "timeout": 300,
      "alwaysAllow": [],
      "env": {
        "PYTHONUNBUFFERED": "1",
        "PYTHONPATH": "/home/leona/projetos/villager-ai-hexstrike-integration"
      }
    },
    "hexstrike-ai": {
      "command": "wsl.exe",
      "args": [
        "-d",
        "Ubuntu",
        "-e",
        "/home/leona/projetos/hexstrike-ai/hexstrike-env/bin/python3",
        "/home/leona/projetos/hexstrike-ai/hexstrike_mcp.py",
        "--server",
        "http://127.0.0.1:8888",
        "--debug"
      ],
      "description": "HexStrike AI (WSL Ubuntu)",
      "timeout": 300,
      "alwaysAllow": []
    }
  }
}

如果 HexStrike 不使用 hexstrike-env替换为实际路径（例如： .venv).

光标设置（向导）

本文介绍如何准备 Cursor 以使用 MCP 服务器来支持您的工作流程。

光标清单（推荐）

确保 MCP 配置文件位于预期位置（通常 C:\Users\<usuario>\.cursor\mcp.json).
请确认 villager-proper 来之前 hexstrike-ai JSON（加载优先级）
重新启动光标（或使用“重新装入窗口”） mcp.json强制重新加载服务器。
至少有一个有效的工具 villager-proper e 1做 hexstrike-ai 在光标工具栏中。

向导提示（prompt）

在光标的“向导/系统提示符”中添加带有决策规则的短文本，例如：

Use o HexStrike para tarefas simples e execucao rapida (uma acao/scan direto).
Use o Villager AI para tarefas complexas que exigem decomposicao e orquestracao multi-etapas.
Se houver falha ou necessidade de mais contexto, escale do HexStrike para o Villager.
Sempre registre evidencias (logs/health) e respeite escopo autorizado.

OpenClaw 配置（向导）

OpenClaw允许您的助手使用不同的通道（并通过网关路由）在多个聊天应用程序中进行对话。通道文档和连接器列表在这里： https://docs.openclaw.ai/channels.

如何运作（概述）

OpenClaw支持多个通信渠道（例如：Telegram，WhatsApp，Discord，Slack等），每个通道都连接到网关。
文本适用于任何频道；媒体资源和反应可能因频道而异。
某些流（尤其是 DM）可能需要配对/允许列表以提高安全性。

一步一步（高级）

选择主频道（例如： Telegram 通常是最快的开始。 WhatsApp 典型的二维码配对）。
按照官方频道文档配置频道凭据。
启动 OpenClaw 并确认网关连接。
执行功能测试：发送简单提示（无破坏性操作）以验证响应、延迟和稳定性。

追踪和控制

Mantenha日志做OpenClaw e dos服务器MCP（村民/HexStrike）。
在向导提示符/指令中设置使用限制和范围，以避免在实验室外执行。

如何旋转（一步一步）

无WSL：
- 克隆/配置 .env
- 骑：

cd ~/projetos/mcp/villager-ai-hexstrike-integration
./scripts/start_villager_proper.sh

无光标：
- 重新装入窗口
- 原生 villager-proper
- 原生 hexstrike-ai
检查：
- curl http://127.0.0.1:8888/health （HexStrike服务器）
- Villager的健康终点

Validacoes rapidas

1）村民服务

curl http://127.0.0.1:37695/health
curl http://127.0.0.1:25989/health
curl http://127.0.0.1:1611/health
curl http://127.0.0.1:8080/health

2）服务器做HexStrike（MCP）

curl http://127.0.0.1:8888/health

故障排除

启动时路径错误（WSL） `hexstrike-ai`

常见症状：

在WSL中运行Python时光标失败，原因是“没有这样的文件或目录”

常见原因：

哦 command/args 做 mcp.json 指向不存在的 venv 路径。

更正：

确认质量不存在WSL故障 hexstrike-ai
更新 mcp.json 正确的路径到 python3 e hexstrike_mcp.py

与 Docker 集成错误

症状：

谈判许可 /var/run/docker.sock

推荐更正：

sudo usermod -aG docker $USER
newgrp docker
docker ps

良好安全实践

目标和测试说明

该软件可用于攻击性安全自动化。仅在授权和定义范围内使用。

睾丸

运行测试套件：

cd ~/projetos/mcp/villager-ai-hexstrike-integration
./tests/run_tests.sh

如果测试需要 venv 的 Python 依赖项，请启用：

source villager-venv-new/bin/activate
python -m pip install --upgrade pip
python -m pip install pytest pytest-cov
./tests/run_tests.sh

Liceca

麻省理工学院。查看文件 LICENSE 为了细节。

使用说明

己糖罢工+村民爱MCP

描述

简介：HexStrike/村民AI

HexStrike AI

村民AI

MCP 角色

官方参考资料

索引

范围和责任

一般建筑

要求

推荐的依赖项

WSL+docker桌面观察器

初始配置

1） 准备非WSL环境

2） 克隆仓库并安装依赖关系

3） 设置 .env

4） 提升村民服务

5） 有效终点健康状况不佳（无WSL）

环境变量（.env）

主要变量

示例块（ 本地查看器）

模块示例（DeepSeek API）

MCP 光标配置

配置文件

重要规则

模板（WSL）

光标设置（ 向导）

光标清单 （推荐）

向导提示 （prompt）

OpenClaw 配置（ 向导）

如何运作（概述）

一步一步（高级）

追踪和控制

如何旋转（一步一步）

Validacoes rapidas

1） 村民服务

2） 服务器做HexStrike（MCP）

故障排除

启动时路径错误（WSL） hexstrike-ai

与 Docker 集成错误

良好安全实践

推荐做法

目标和测试说明

睾丸

Liceca

相关 MCP

AI网络安全自动化平台

远程MacOS控制服务器

AI提示编程工具

漏洞情报服务器

智能体工作空间

渗透测试工具服务器