跳到正文
ARTEX.sh

ARTEX MCP:内置服务端、外部桥接,以及 MCP 客户端。

MCP(Model Context Protocol)让 AI Agent 能调用其他系统里的工具。ARTEX 以三种方式接触 MCP。从 v0.3.30 起,它可以运行自己的 MCP 服务端,让外部 Agent 管理任务。另有一个独立仓库把 ARTEX 渗透测试控制台桥接给 MCP 客户端。而 ARTEX 的 Worker 自己也会调用远程 MCP 服务。本页逐一说明,并列出相关端口和各 README 对安全的提示。

新增 MCP 服务端的版本,2026-11-14
v0.3.30
内置服务端的工具数
11
artex-mcp 桥接的工具数
10
默认控制台与 API 端口
8787

ARTEX 内置 MCP 服务端:v0.3.30 新增,默认关闭。

RuoJi6 在 2026-11-14 发布的 v0.3.30 带来了一个 MCP 服务端,让外部 Agent 可以运行任务。README 说明,个人助手或机器人之类的外部 Agent 可以查看任务和漏洞、创建任务,以及暂停或恢复任务。管理员在系统设置的系统与账号里打开 MCP 服务端,关闭时 /mcp 返回 404。

README 把两个方向分得很清楚。系统里的 MCP 页面管理的是 ARTEX 自己的 Agent 去调用的外部 MCP 服务。这里说的服务端则是 ARTEX 对外提供的端点,地址是 ARTEX 地址加上 /mcp。它使用无状态的 Streamable HTTP,只返回 JSON,不支持 SSE,也不支持 stdio。客户端把访问令牌作为 Bearer 令牌发送,令牌以 artex_mcp_ 开头,创建时只显示一次。

令牌只能看到所属权限范围内的工具。令牌还可以限定在指定企业内,并可设置未结束任务数上限、每小时创建任务数上限、有效期和即时吊销。README 指出,企业限制是把任务绑定到资产范围,并不是网络层拦截,需要硬性限制时应使用资产拦截规则。

  • read 权限

    7 个工具

    list_tasks、get_task、get_task_graph、list_task_findings(不含原始请求和响应流量)、list_companies、list_task_categories、list_llm_profiles(不含 API Key)。

  • task:create 权限

    1 个工具

    spawn_task 创建并启动任务,可以带 company_ids 和 category_id。

  • task:control 权限

    3 个工具

    pause_task、resume_task 和 add_task_hint。

  • 不对外开放的能力

    创建或修改自定义工具、MCP 服务和技能,读写工作区文件,LLM 密钥,以及系统设置。

防守方需要知道:/mcp 不经过 Basic Auth。

README 明确写到,/mcp 不经过 HTTP Basic Auth,只认访问令牌,不接受 Basic 账号密码、控制台密码或管理员登录令牌。所以开启 Basic Auth 并不会给 /mcp 增加保护。README 建议使用来源白名单,填写 IP 地址或 CIDR 范围,它在令牌之前检查,不在名单内的来源一律返回 403。部署在反向代理之后时,通过可信代理设置让 ARTEX 只信任你列出的代理所带的 X-Forwarded-For。带 Origin 头的浏览器请求会被拒绝并返回 403,/mcp 也不发送 CORS 头。

每次调用都会记录令牌、工具、参数、结果、来源地址和时间,因权限不足被拒绝的调用也在其中,设置页保留最近 20,000 条。README 还警告:spawn_task 会发起真实的安全测试;目标返回的文本可能夹带提示注入;令牌放在请求头里传输,公网暴露时必须使用 HTTPS。

作为 MCP 客户端的 ARTEX:远程服务与内置工具。

反过来,ARTEX 的 Worker 会调用 MCP 服务。README 说明,在系统设置中,远程 MCP 可以选择 http(Streamable HTTP)或 sse(旧版 SSE),Docker 镜像里也带有 Playwright MCP,工作原理页的工具清单里能看到。部分 Fork 做得更多。

  • wpsec/ARTEX-Pro

    ARTEX-Pro 迭代版

    内置 OWASP ZAP 2.17.0 和 MCP Integration 插件 0.4.0,默认启动。ZAP 的工具会显示在 MCP 页面,现代单页应用则用 Playwright MCP 探索。

  • MoLeft/ARTEX

    v0.26.11.07.005

    浏览器 MCP 不再是内置服务。系统配置里有 Chrome 和 Lightpanda 两个开关,打开后会创建名为 browser 和 lightpanda 的普通 MCP 条目,可以在 MCP 页面改名、限制可见性或删除。它还可以限制并发浏览器会话数,该功能标注为实验性。

  • TATHPE/ARTEX-Endfield

    REA MCP

    把 REA(面向二进制、APK、固件和 JavaScript 的 MCP 服务与命令行工具)接入为 MCP 工具服务,并内置了写入随包 REA 运行时的步骤。

  • azrielnan/artex-ko-main

    REA MCP 预设

    MCP 页面里有一个可选的 REA 预设,用来分析本地程序和软件包。

  • chu0119/Pojun

    攻击型

    README 列出了 FOFA 测绘、Playwright 和 Burp 的 MCP 预设。本指南只链接它的分支页面。

    artex.sh 上的分支页面仅提供分支页面:攻击型版本不附外链

外部 MCP 桥接:nu11b1ade/artex-mcp。

nu11b1ade/artex-mcp 是一个独立的 stdio MCP 服务端。它运行在外部 Agent 所在的机器上,通过 ARTEX 的 Web 地址进行管理,所以 Docker、二进制和反向代理部署都适用。它的 README 是中文,其中说明需要 Web 访问权限和 ARTEX 管理员凭据,密码从文件读取,接口目录收录了固定提交的 nu11b1ade/ARTEX 源码里 315 个 HTTP 方法与路由组合,共提供 10 个工具。示例客户端是 Hermes 和 Pi,同样的 stdio 配置也适用于其他 MCP 客户端。

README 警告,该桥接拥有所配置账号的管理员权限,部分路由会产生真实影响,包括执行 Repeater 请求、修改审批或 MCP 配置。调用方应把网页、日志和流量正文当作数据处理。stdio 桥接与内置服务端的设计不同,后者是使用带权限范围令牌的 Streamable HTTP。

  • 会话工具

    4 个工具

    artex_status、artex_login、artex_initialize 和 artex_logout。

  • 凭据工具

    2 个工具

    artex_change_password 和 artex_configure_basic_auth。

  • 路由工具

    3 个工具

    artex_find_routes 搜索目录,artex_call 执行路由,artex_read_events 在限定时间内读取日志和任务事件流。

  • artex_browser

    AGPL-3.0,最后推送 2026-11-03

    可选的隔离 Chromium,用于只存在于网页界面里的功能,例如 Repeater 本地工作区。

ARTEX 控制台与端口:控制台 8787,代理 8788。

ARTEX 渗透测试控制台是嵌入 Go 程序的 Next.js 网页应用。默认情况下,控制台和 API 监听 8787 端口,保存工具流量的记录代理使用 8788 端口,并带有自己的证书颁发机构,工作原理页也列出了这两个端口。README 给出的 MCP 端点是 ARTEX 地址加上 /mcp,而不是单独的端口号。

2026-11-04 发布的 BaaRai v0.5.0 让 Docker 默认只在 127.0.0.1 上发布 8787 端口。0x7377 课程实训包把控制台放在 127.0.0.1:8787,把 CVE MCP 服务放在 127.0.0.1:8800/mcp,容器网络内部则使用 8000 端口。暴露在互联网上的控制台是已知的问题,而且 v0.3.14 存在登录绕过,所以请不要把控制台开放到互联网上。

持续关注 ARTEX 动态。

新分支、新版本和新报告,均标注日期并附来源。

带有发光光柱的等距平面