【AI工具】大白哥开发了vshell-mcp

admin 2026-11-21 02:30:08 网络安全文章 来源:ZONE.CI 全球网 0 阅读模式

【AI工具】大白哥开发了vshell-mcp

dbg
dbg

大白哥AI与安全

2026年11月20日 09:00
安徽

去阅读

最近大白哥在用AI开发一些新的攻防工具

刚好无聊写了一个vshell的mcp,免费分享给大家,方便师傅们使用agent配合c2自动化打内网

VShell C2 web控制台的 MCP 服务,用 Rust 从零实现,Streamable HTTP 传输。

用账号密码登录换 JWT,把 VShell 的能力(Agent、命令执行、文件、SOCKS5 隧道、监听器) 以 35 个 MCP 工具暴露给 Claude code、codex、deepseek harness  等支持 HTTP 的 MCP 客户端。

仅用于自有资产、隔离靶场或已获书面授权范围内的测试。

为什么用 Rust 写

本项目是用 Rust 实现的(不是脚本封装,也不是对现成二进制的包装),主要看中这几点:

  • 零依赖单文件:Windows 静态 CRT、Linux 静态 musl,拷过去就能跑,不要求目标机装 Java / Node / Python 或运行时库。
  • 常驻进程更稳:无 GC、无运行时,长时间挂着不会因垃圾回收抖动或内存越界出错;基于 tokio 异步,一个进程可同时服务多个 MCP 客户端。
  • 体积小、启动快:发行版 3–4 MB,毫秒级启动,放进面板目录几乎不占空间。
  • 编译期强类型:JSON-RPC 协议层、35 个工具的入参与面板接口映射都在编译期校验,接口调整时改动可控。

兼容性

维度 约定
MCP 传输 Streamable HTTP(POST /mcp,响应 application/json 或 text/event-stream)
工具 35 个 vshell_* 工具,名称 / 参数 / schema 固定
鉴权 Authorization: Bearer <token> ,所有请求必填
会话 initialize 下发 Mcp-Session-Id,后续请求可携带(服务端不强制)
发行版 只提供预编译二进制(dist/),无需自行编译
客户端配置 type: http + url + headers.Authorization

部署与启动(一键脚本)

scripts/vshell-mcp-start.sh 面向 VShell 目录:读取 conf/setting.conf 的端口与账号, 拉起vshell服务端,再拉起本 MCP,并在每次启动时随机生成访问令牌。直接用发行版二进制,不需要编译。

# 1) 解压发行版(内含 vshell-mcp 与 vshell-mcp-start.sh)
tar xzf vshell-mcp-0.1.0-linux-amd64.tar.gz

# 2) 放进vshell目录(与 v_linux_amd64、conf 同级)
cd /path/to/vshell
cp /path/to/linux-amd64/vshell-mcp /path/to/linux-amd64/vshell-mcp-start.sh .
chmod +x vshell-mcp vshell-mcp-start.sh

# 3) 一键启动
./vshell-mcp-start.sh start     # vshell + MCP,打印令牌与客户端配置
./vshell-mcp-start.sh status    # 进程、端口、自检、当前令牌
./vshell-mcp-start.sh restart   # 重启(令牌更换)
./vshell-mcp-start.sh logs      # 尾部日志
./vshell-mcp-start.sh stop      # 停止两者

  • 令牌每次 start 重新随机生成,写入 run/mcp-token.txt(0600)并打印;重启后旧令牌失效。
  • 生成顺序:openssl rand → /dev/urandom(tr+head)→ 纯 bash $RANDOM, 不要求安装 openssl;健康检查优先 curl,缺失时用 bash /dev/tcp 发原始 HTTP。
  • run/mcp-config.ini 含vshell密码,权限 600;面板已在运行时脚本复用并提示,不重复启动。

接入 MCP 客户端

{
  \"mcpServers\":{
    \"vshell-mcp\":{
      \"type\":\"http\",
      \"url\":\"http://<MCP主机IP>:8765/mcp\",
      \"headers\":{\"Authorization\":\"Bearer <令牌>\"}
    }
}
}

部署后自检

curl -s http://127.0.0.1:8765/mcp -H 'Content-Type: application/json' -H \"Authorization: Bearer token值\" -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"ping\"}'
# 期望返回 {\"result\":{}}

在客户端里调用 vshell_info 应返回面板版本、在线 Agent 与监听器数量;tools/list 应列出 35 个工具。

实战检测

接入Agent

在agent中使用vshell mcp管理上线的主机

使用vshell mcp进行内网横向

常见问题

现象 原因 / 处理
401 且带 WWW-Authenticate: Bearer 令牌不匹配。脚本每次 start 都会换令牌,用 ./vshell-mcp-start.sh token 取当前值
405 Method Not Allowed 正常:/mcp 只接受 POST,GET / DELETE 一律 405
局域网连不上 脚本默认监听 0.0.0.0:8765;确认防火墙放行 8765,面板 8089 只绑 127.0.0.1 即可
端口被占用 换端口:MCP_ADDR=0.0.0.0:8766 ./vshell-mcp-start.sh start
提示缺少令牌、退出码 2 只在直接运行二进制时出现;脚本会自动生成,也可 MCP_TOKEN=<≥16 位> ./vshell-mcp-start.sh start 指定
面板密码含特殊字符 脚本从 conf/setting.conf 读取,不要用命令行传参,避免留在 shell 历史

工具

工具 参数 说明
vshell_info — 面板版本、在线 Agent、监听器、隧道、授权截止
vshell_clients status =online/offline/all Agent 列表,默认 online
vshell_exec client_id 、command、timeout(默认 30,≤600) 同步执行并返回输出
vshell_exec_async client_id 、command 异步下发,不等待结果
vshell_disks client_id 磁盘列表
vshell_ls client_id 、path、page、page_size、sort_by、order 目录分页/排序
vshell_cat client_id 、path、max_bytes(默认 102400,≤1048576) 文本原样返回 text;含 NUL、控制字符过多或非 UTF-8 的内容返回 base64 并附 note(二进制请改用 vshell_download 取原文)
vshell_write client_id 、path、content 或 local_file 写入远程文件
vshell_rm client_id 、path 删除文件/目录
vshell_upload client_id 、local_path、remote_path、timeout 上传本地文件到 Agent
vshell_download client_id 、remote_path、wait(默认 30,≤600) 让 C2 从 Agent 拉取文件到服务器
vshell_listeners — 监听器列表
vshell_runners — 内置工具列表
vshell_socks_start client_id 、port(默认 1080) 创建并启动 SOCKS5 隧道
vshell_socks_stop port 按端口停止并删除隧道
vshell_socks_list client_id (可选) 隧道列表
vshell_listener_add listen_addr 、connect_addr、mode(默认 tcp)、remark、encrypt_salt、vkey、max_dns_size、ping_interval、disconnect_timeout、public_dns、dns_domain、oss_url 新增监听器,返回新建记录
vshell_listener_edit id 、listen_addr 及其余同 add 修改监听器
vshell_listener_rm id 删除监听器
vshell_listener_start / vshell_listener_stop id 启动 / 停止监听器
vshell_listener_remark id 、remark 修改监听器备注
vshell_build_client listener_id 、arch、upx、proxy、save_to 生成载荷并保存到 MCP 主机,返回路径与大小
vshell_runner_run client_id 、plugin、args 内存加载运行插件并返回输出
vshell_runner_upload local_path 上传插件到 plugins 目录
vshell_tunnel_add client_id 、mode(socks5/http/tcp/udp)、port、target、username、password、remark 新增隧道,返回隧道 ID
vshell_tunnel_edit id 、client_id、port 及其余同 add 修改隧道
vshell_tunnel_rm id 删除隧道
vshell_tunnel_start / vshell_tunnel_stop id 启动 / 停止隧道
vshell_tunnel_remark id 、remark 修改隧道备注
vshell_tunnel_list client_id (可选) 隧道列表
vshell_client_remark client_id 、remark 修改 Agent 备注
vshell_client_clear client_id 、what=files/processes/list 清理面板里该 Agent 的记录
vshell_diagnose — 登录、面板接口、系统 curl 诊断

工具执行失败时返回 isError: true 的文本结果(不是 JSON-RPC error)。

免责声明

本项目(vshell-mcp)是 VShell 的第三方非官方 MCP 适配层,只做接口协议转换, 不包含 VShell 本体,也未获得 VShell 作者/厂商的任何授权、认可或背书。

  • 仅限合法授权用途:只可用于自有资产,或已获得资产所有者书面授权的渗透测试、红蓝对抗、 应急演练、教学与科研场景。禁止用于任何未授权的访问、控制、数据获取、持久化或破坏行为, 禁止用于对互联网资产的批量探测与攻击。
  • 使用者自行承担全部责任:使用、分发、部署本项目及其生成的载荷所引发的一切后果——包括但不限于 数据丢失、业务中断、第三方索赔、行政处罚与刑事责任——均由使用者承担;作者与贡献者不承担任何 直接或间接责任。
  • 与 VShell 官方无关:VShell 的名称、商标与版权归其各自所有者。本项目不提供、不修改、不重新 分发 VShell 的面板与客户端程序;使用者需自行通过合法渠道获取 VShell 并遵守其许可协议与 服务条款,由此产生的授权与费用问题与 本项目无关。
  • 接口兼容性不作保证:面板接口信息来自公开前端资源与运行时行为探测,未使用 VShell 源码。 接口可能随版本升级而变更,本项目不承诺与任何特定版本兼容,也不承诺持续维护或修复。
  • 按“现状”提供(AS IS):不提供任何明示或默示担保,包括但不限于适销性、特定用途适用性及 不侵权担保;对因使用或无法使用本软件造成的任何损失(含利润损失、数据丢失、服务中断)不承担责任。
  • 令牌等同控制权:MCP Bearer 令牌泄露即等同于将 Agent 控制权交给对方。部署方负责令牌的生成、 保管、轮换与访问控制,不得将服务直接暴露在公网,不得将令牌写入代码仓库、脚本历史或聊天记录。
  • 遵守当地法律法规:请在所在司法辖区法律允许的范围内使用,并遵守《中华人民共和国网络安全法》 《中华人民共和国刑法》第二百八十五条、第二百八十六条等规定以及目标系统的服务条款。 本文档不构成法律意见;用于商业交付或对外服务前,请自行取得书面授权并完成合规评估。
  • 继续使用即视为接受:一旦下载、编译、部署或调用本项目,即表示你已阅读、理解并同意上述全部条款。 如不同意,请立即停止使用并删除全部副本。

vshell-mcp获取方式

转发本文章到任意安全群或者是转发朋友圈点赞超过10个,即可加入vshell-mcp分享群获取vshell-mcp工具

如果对vibe coding感兴趣也可以加入帮会,第一时间获取大白哥开发的工具

02

大白哥帮会

本帮会只做一件事就是以实战案例的形式分享AI渗透、AI攻防、AI代码审计、AI工具、AI模型,以及任何AI与网络安全相关的内容。

目前已更新内容:

20.【AI工具】vshell-mcp工具

19.【AI靶场】企业级OA靶场

18.【AI模型】deepseek7.5折模型

17.【AI工具】dotnet-audit-skills —— .NET 代码安全审计

16.【AI工具】攻防演练专用内网信息收集skill lan-recon

15.【AI工具】攻防演练专用哥斯拉mcp -- gsl-mcp

14.【AI工具】360-low-risk skill — AI 驱动的 360低风险skills

13.【工具分享】jeecgboot漏洞检测工具 | 支持jeecgboot多种安全漏洞

12.【工具分享】Fscan — 多层级免杀对抗方案

11.【AI工具】php-audit Skill — AI 驱动的 php代码审计skills

10.【AI工具】Swagger-Scan Skill AI 驱动的 SwaggerAPI漏洞自动化扫描

9.【AI工具】一键快速检测模型存活工具

8.【AI免杀】大白哥免杀skills分享

7.【AI工具】零零信安高级会员key

6.【AI工具】手机上如何使用gpt模型

5.【AI渗透】大白哥教你用AI打CTF

4.【AI资讯】GPT Cyber认证服务介绍

3.【Al渗透】大白哥教你破解codex限制

2.【AI工具】用AI1:1复刻SRC挖掘工具

1.【AI安全】间接提示词注入实现RCE(CVE-2025-53773绕过分析)

👇关注【大白哥AI与安全】公众号, 获取AI安全前沿技术与工具分享👇


不用Docker手工造容器:从 unshare 到1号进程(含CRI冷启动对照) 网络安全文章

不用Docker手工造容器:从 unshare 到1号进程(含CRI冷启动对照)

本文探讨了手工构建容器的方法,包括使用unshare和pivot_root技术,并与KVM虚拟机和chroot目录隔离进行了比较。文章详细介绍了手工容器构建的步骤,包括镜像拉取、命名空间隔离、根文件系统切换等,并分析了手工容器与宿主机之间的关系。此外,文章还讨论了手工容器构建过程中可能出现的故障和解决方案。
评论:0   参与:  0