CS-MCP

CS-MCP

让 Claude 替你操作 Cobalt Strike。

不用点 GUI，不用写 Sleep 脚本，直接用自然语言让 AI 帮你列 beacon、执行命令、生成 payload。基于 CS 自带的 agscript 无头客户端，不依赖 REST API，CS 4.8 破解版就能跑。

为啥要自己写一个

MickeyDB/Cobalt-Strike-MCP 是目前最完善的 CS MCP 方案，200+ 工具，但它依赖 CS 4.12 新增的 REST API。4.12 之前的版本（包括 uCare@Pwn3rs 破解的 4.8）只有 agscript 命令行入口。

于是有了这个项目 — 绕开 REST API，直接搓 agscript：

• 动态 CNA 生成：每次操作实时生成一个 Sleep 脚本，喂给 agscript 执行，结果写到临时文件再解析回来
• artifact_payload 可用：踩坑后发现 artifact_payload() 在 headless 模式下直接返回数据，不依赖 GUI 回调（artifact_stageless() 就不行，会在 headless 卡死）
• payload 生成打通：证明 headless 也能生成 exe/dll/raw/powershell/python 全格式
• HTTP Hosts 字段问题：发现 listener_create 只设了 Stager Host，beacon 回连实际用的是 beacons 字段（HTTP Hosts），headless 下得用 GUI 补设

接入 Claude Code

git clone https://github.com/fg-time/Cobalt-Strike-4.8-MCP.git && cd cs-mcp && pip install mcp && python cs_mcp_server.py test

加到 .claude/settings.json 里：

{
  "mcpServers": {
    "cs-mcp": {
      "command": "python",
      "args": ["D:/ct gongji/cs-mcp/cs_mcp_server.py"]
    }
  }
}

或者用环境变量配 TeamServer 地址和密码：

export CS_DIR="D:/ct gongji/cs"
export CS_HOST="127.0.0.1"
export CS_PORT="50050"
export CS_PASS="123"
python cs_mcp_server.py

能干什么

接入后直接跟 Claude 说话就行，比如：

• "列一下现在有几个 beacon"
• "对 xxx beacon 执行 whoami"
• "给 http 监听器生成个 x64 exe 存到 payloads 目录"
• "把 beacon 的 sleep 改成 3 秒"

一共 11 个工具：

| 工具 | 干什么的 | |------|---------| | cs_list_beacons | 列出所有在线 beacon，包含用户名、机器名、内外网 IP | | cs_list_listeners | 列出所有监听器，包含回连地址和端口 | | cs_get_beacon | 查某个 beacon 的详细信息 | | cs_get_listener_detail | 查监听器完整配置，包括 HTTP Hosts 和 Stager Host | | cs_exec_beacon | 在 beacon 上执行 shell 命令 | | cs_beacon_sleep | 调整 beacon 回连间隔和抖动 | | cs_beacon_note | 给 beacon 加备注 | | cs_beacon_kill | 干掉某个 beacon | | cs_create_listener | 新建监听器（HTTP/HTTPS/DNS/SMB/TCP 都行） | | cs_delete_listener | 删监听器（CS 4.8 只能在 GUI 删，这个会提示你） | | cs_generate_payload | 生成 payload，支持 raw/exe/dll/powershell/python，x64/x86 |

怎么工作的

你说话 → Claude → MCP → Python 动态生成 CNA → agscript → TeamServer
                                                        ↓
                                                 结果写进临时文件
                                                        ↓
你看到结果 ← Claude ← JSON ← Python 解析 ←────────────┘

每次操作会启动一个新的 agscript 进程（JVM 冷启动大概 5 秒），执行完就退出。没有长连接，不用担心占着坑导致 GUI 登不上。

跟同类项目的区别

| | CS-MCP | MickeyDB MCP | sleep_python_bridge | |---|---|---|---| | 支持版本 | CS 4.8 | CS 4.12+ | CS 4.8 | | 通信方式 | agscript 动态 CNA | CS REST API | agscript + pexpect | | Windows 能用 | ✅ | ✅ | ❌ pexpect 不兼容 | | 工具数量 | 11 | 200+ | Python 函数库 | | payload 生成 | ✅ artifact_payload | ✅ REST API | ✅ | | 创建监听器 | ⚠️ stager host OK，HTTP Hosts 建议 GUI 确认 | ✅ API 完整 | ✅ |

简单来说：MickeyDB 功能最全但要 CS 4.12+，sleep_python_bridge 在 Windows 跑不了，CS-MCP 是 CS 4.8 破解版在 Windows 上唯一能用的 LLM 控制方案。

CS 4.8 的坑

| 情况 | 状态 | 说明 | |------|------|------| | artifact_payload() | ✅ 能用 | 直接返回数据，不卡 | | artifact_stageless() | ❌ 卡死 | 依赖 GUI 异步回调，headless 模式必挂 | | listener_create() | ⚠️ 半残 | 能设 Stager Host，但 HTTP Hosts（beacons 字段）没设上，payload 生成的回连地址可能是错的。建议创建后用 cs_get_listener_detail 验证 | | listener_remove() | ❌ 没有 | CS 4.8 headless API 不支持，去 GUI 删 | | 多监听器同端口 | ❌ 冲突 | 后面创建的会静默失败，日志里能看到 Another Beacon listener exists on port XXXX |

License

MIT