【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安全前沿技术与工具分享👇
版权声明
本站仅做备份收录,仅供研究与教学参考之用。
读者将信息用于其他用途的,全部法律及连带责任由读者自行承担,本站不承担任何责任。










评论