
Godzilla-MCP-Headless
哥斯拉 MCP 无头版:不启动哥斯拉 GUI,直接用 stdio/HTTP 驱动你的 Webshell(生成马 / 命令执行 / 文件管理),兼容 Claude Desktop、Claude Code、Cursor 等 MCP 客户端。基于 hkdonline/Godzilla-MCP 改版。
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up Godzilla-MCP-Headless (release-binary project) into my current project. Found on https://claudeers.com/godzilla-mcp-headless Repo: https://github.com/Ch1ngg/Godzilla-MCP-Headless Homepage/docs: — Detected install method: release-binary → inspect the README Category: mcp-servers. Platforms: cli, api, desktop. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: active; community-verified: false. Confirm the source before running anything.
Grab the latest release asset from GitHub.
# download a build from https://github.com/Ch1ngg/Godzilla-MCP-Headless/releases
git clone https://github.com/Ch1ngg/Godzilla-MCP-Headless
// compatibility
| Platforms | cli, api, desktop |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | — |
| Pricing | open-source |
| Language | Java |
Godzilla-MCP Headless · 哥斯拉 MCP 无头版
把 hkdonline/Godzilla-MCP(上游改版自 cns1rius/godzilla-mcp)改造成无需启动哥斯拉 GUI 即可运行的 MCP 服务器。
- 🔌 两种传输:
stdio(Claude Desktop / Claude Code / Cursor 直接拉起,零端口)与HTTP/SSE(常驻服务,任意 MCP 客户端可接入) - 🗂 直连你的哥斯拉数据:与哥斯拉共用同一个
data.db,已保存的 Webshell 直接可用 - 🧩 同一份 JAR 双形态:也可以放进哥斯拉
shells/plugins/java/当插件用(菜单照常) - 🛠 56 个工具:会话 / 文件 / 大文件传输 / 命令与代码 / 虚拟终端 / 内存马 / 端口扫描 / 数据库 / PHP 专属 / Windows 与 .NET / 插件库管理 / 马生成
- ✅ 全链路实测:Java(Tomcat)、PHP 8.5 / 7.4、FastCGI-FPM 三类靶机(命令 / 代码 / 虚拟终端 / 压缩 / 端口扫描 / FPM RCE / disable_functions 绕过)
仅把自有
godzilla.jar当类库使用,不需要、也不会启动哥斯拉主程序。
功能一览(56 个工具)
| 类别 | 工具 |
|---|---|
| 会话管理 | list_shells add_shell connect_shell(免保存直连)disconnect_shell list_sessions test_connection remove_shell |
| 生成/配置 | generate_shell(JSP/PHP/C#/ASP 全系马,14 种 cryption)get_env_config |
| 系统信息 | get_basics_info current_user process_list network_info screenshot |
| 命令/代码 | exec_command exec_code(PHP/ASP 代码执行)real_cmd(虚拟终端,PHP/Java/C#) |
| 文件操作 | list_files read_file write_file upload_file download_file delete_file copy_file move_file new_file new_dir list_root file_size file_remote_down big_file_upload |
| 数据库 | exec_sql list_databases enum_database_conn |
| 高级能力 | port_scan(Java/PHP/C#)memory_shell_inject memory_shell_list memory_shell_unload filter_shell_add filter_shell_list filter_shell_remove zip(压缩/解压,Java/PHP/C#) |
| PHP 专属 | php_ps(免命令进程列表)php_webshell_scan(Webshell 扫描)php_bypass_open_basedir php_bypass_disable_functions(mem/env/fpm/amc 四方式)php_attack_fpm(FastCGI 直打 FPM) |
| Windows / .NET | mimikatz(内存加载抓密码)petit_potam shellcode_load windows_privesc(bad/sweet/efs/lemon 提权四件套)sharp_web(浏览器凭据)csharp_memory_shell(C# 内存马) |
| 哥斯拉库管理 | plugin_list plugin_add plugin_remove |
协议:MCP 2024-11-05(JSON-RPC 2.0),端点 /mcp(HTTP 模式)或 stdio。
下载
- 方式一(推荐):前往 Releases 下载
godzilla-mcp-<版本>.jar—— 由 GitHub Actions 在打 tag 时自动构建发布,无需本地编译。 - 方式二:Fork 本仓库,推送到
main后从 Actions 的 Artifacts 下载最新构建。 - 方式三:自行构建(见「构建」)。
依赖
| 依赖 | 说明 |
|---|---|
| JDK 8+ | 运行与构建(JDK 8 / 11 / 17 实测可运行) |
godzilla.jar | 运行时需要,从你自己的哥斯拉安装目录获取(仅作类库) |
| 构建依赖 | 编译用 Maven Central 的 io.github.beichendream:godzilla:4.01,无需手工放置任何 jar |
安装 & 使用
0. 获取
git clone https://github.com/Ch1ngg/Godzilla-MCP-Headless.git
cd Godzilla-MCP-Headless
# 从 Releases 下载 godzilla-mcp-<版本>.jar,放到仓库根目录(或任意位置并设置 MCP_JAR)
准备 godzilla.jar:放在任意目录,通过 GZ_HOME 指向(脚本自动探测 ./godzilla → ~/Godzilla → 当前目录)。
1. stdio 模式(推荐:Claude Desktop / Claude Code / Cursor)
客户端拉起进程、走标准输入输出:无需端口、无需常驻服务。
Claude Desktop(claude_desktop_config.json):
{
"mcpServers": {
"godzilla": {
"command": "/绝对路径/Godzilla-MCP-Headless/scripts/run-stdio.sh",
"env": { "GZ_HOME": "/你的哥斯拉目录(含 godzilla.jar 与 data.db)" }
}
}
}
Claude Code:
claude mcp add godzilla /绝对路径/Godzilla-MCP-Headless/scripts/run-stdio.sh
Windows(cmd):command 换成
C:\...\Godzilla-MCP-Headless\scripts\run-stdio.bat(写进 JSON 时反斜杠需双写\\)。godzilla.jar/data.db就在~/Godzilla时,连env都不用配。
2. HTTP 模式(常驻 / 远程接入)
./scripts/run-http.sh # 默认 http://127.0.0.1:5566/mcp
./scripts/run-http.sh 8899 0.0.0.0 # 自定义端口 / 绑定地址
# Windows(cmd): scripts\run-http.bat 8899 0.0.0.0
客户端(url 型):
{ "mcpServers": { "godzilla": { "url": "http://127.0.0.1:5566/mcp" } } }
⚠️ HTTP 模式无鉴权(沿袭上游设计),默认绑定
127.0.0.1;对外部署请自行加防火墙或反代鉴权。
3. 放回哥斯拉当插件(可选)
把 godzilla-mcp-<版本>.jar 放进哥斯拉 shells/plugins/java/,重启哥斯拉,顶部菜单启动即可。同一份 JAR 自动识别两种运行形态。
无图形界面(VPS)安装插件
哥斯拉把插件登记在 data.db 的 plugin 表(存的是 jar 的绝对路径文本)。无 GUI 环境三种方式任选:
方式 A:MCP 工具(服务已连通时,让 AI 直接管理)
plugin_list # 查看已注册插件
plugin_add /opt/gz/plugins/MyPlugin.jar
plugin_remove /opt/gz/plugins/MyPlugin.jar
方式 B:自带脚本(无需 JVM / 无需显示,纯 Python 标准库)
python3 scripts/plugin.py list
python3 scripts/plugin.py add /opt/gz/plugins/MyPlugin.jar
python3 scripts/plugin.py remove /opt/gz/plugins/MyPlugin.jar
# --db 可指定 data.db 路径;默认探测 $GZ_HOME / $MCP_WORKDIR / ./ / ~/Godzilla
方式 C:sqlite3 直接写库(零依赖)
cd /opt/gz # 与 data.db 同目录
sqlite3 data.db "INSERT OR IGNORE INTO plugin(pluginJarFile) VALUES ('/opt/gz/plugins/MyPlugin.jar');"
sqlite3 data.db "SELECT * FROM plugin;"
sqlite3 data.db "DELETE FROM plugin WHERE pluginJarFile='/opt/gz/plugins/MyPlugin.jar';"
注意:始终使用绝对路径(相对路径按哥斯拉进程工作目录解析);目标 jar 不存在时哥斯拉会静默跳过(日志
no found);修改后重启哥斯拉生效。 如果必须用 JVM 方式注册(Db.addPlugin),注意哥斯拉核心初始化会读取屏幕尺寸,无显示的 Linux 上先装xvfb(xvfb-run java ...);上述 A/B/C 三条路线均无此限制(A 也是通过核心库调用,但运行在已有虚拟显示的环境里;B/C 完全不需要)。
使用示例
对话式指令(AI 自动调用对应工具):
连接 http://target/shell.jsp,密码 pass123,密钥 0123456789abcdef
在目标上执行 /bin/sh -c "id; uname -a"
把 /etc/passwd 下载到本地 /tmp/passwd
扫描 127.0.0.1 的 22,80,8080 端口
在目标注入内存马 /favicon.ico,密码 mem123,密钥 memkey123456
生成哥斯拉马:
{ "name": "generate_shell", "arguments": {
"cryption": "JAVA_AES_BASE64", "password": "pass123", "secretKey": "0123456789abcdef",
"outputPath": "/tmp/shell.jsp" } }
生成后上传到目标,用同组「密码/密钥」+ 对应 payload/cryption 连接(JSP:JavaDynamicPayload+JAVA_AES_BASE64;PHP:PhpDynamicPayload+PHP_XOR_BASE64)。
密钥在生成时按哥斯拉规则自动派生 md5(secretKey)[0:16]。
支持的完整矩阵(与哥斯拉核心生成器逐字节一致):
JAVA_AES_BASE64/RAW(suffix: jsp/jspx)、PHP_XOR_BASE64/RAW、PHP_EVAL_XOR_BASE64、CSHAP_AES_BASE64/RAW(suffix: aspx/asmx/ashx)、CSHAP_ASMX_AES_BASE64、CSHAP_EVAL_AES_BASE64、ASP_XOR_BASE64/RAW、ASP_BASE64/RAW、ASP_EVAL_BASE64。
注意事项
- exec_command(Java 载荷):单进程 + 参数拆分语义,复合命令需包一层 shell:
/bin/sh -c "id; echo OK";PHP 载荷可直接;串联。 - exec_code(PHP / ASP 载荷):PHP 依赖目标
output_buffering > 0(主流发行版默认 4096;PHP-CLI 内置服务器需-d output_buffering=4096)。 - 内存马:Java 用
memory_shell_inject(支持AES_BASE64/AES_RAW/Behinder/Cknife/ReGeorg),注入后可用同密码/密钥以JAVA_AES_BASE64连接;Servlet 型用memory_shell_list/unload管理,Filter 型用filter_shell_*管理;C#/.NET(IIS)用csharp_memory_shell。 - real_cmd(虚拟终端):需要目标支持并发请求(Apache / PHP-FPM / 多 worker php -S);单进程 php -S 会被长挂终端请求独占(上游插件机制如此)。
环境变量
| 变量 | 作用 | 默认 |
|---|---|---|
GZ_HOME | godzilla.jar 所在目录 | 自动探测 ./godzilla → ~/Godzilla → 当前目录 |
MCP_WORKDIR | data.db 工作目录(决定使用哪个数据库) | 同 GZ_HOME |
MCP_JAR | 插件 JAR 路径 | 自动查找 dist/、仓库根、target/、脚本同级 |
JAVA | java 可执行文件 | java |
MCP_PORT / MCP_HOST | HTTP 模式端口 / 绑定地址 | 5566 / 127.0.0.1 |
工作原理(为什么不用启动哥斯拉)
插件真正依赖 godzilla.jar 的只有三块能力:core.Db(读写 data.db)、core.shell.ShellEntity + core.imp.Payload(Webshell 通信协议)、HTTP 服务。无头启动器(GodzillaMcpHeadlessBootstrap)做三件事:
- 设置
godzilla.mcp.headless=true→ 跳过 GUI 菜单注册(放回哥斯拉运行时该标志不存在,菜单照常注册); - 调用
ApplicationContext.init()扫描 payload / cryption 注册表(哥斯拉 GUI 启动时会做,无头环境需手动补齐,否则会 NPE); - 启动 MCP 服务(stdio 或 HTTP)。
注意:data.db 是 SQLite 相对路径(jdbc:sqlite:data.db),工作目录决定用哪个数据库 —— 脚本会自动切换到 MCP_WORKDIR。
构建
GitHub Actions(默认,推荐)
推送到 main / PR 自动构建;打 v* tag 自动创建 Release 并附带本 jar。工作流:.github/workflows/build.yml。
本地构建(可选)
mvn -q package # 依赖来自 Maven Central,无需手工准备 lib/
# 产物: target/godzilla-mcp-<version>.jar
无 Maven 环境(可选,需本机有 godzilla.jar):./scripts/build.sh(GZ_HOME 或 lib/godzilla.jar)。
自测(可选)
python3 test/smoke_test.py "http://127.0.0.1:18080/gz/shell.jsp" "pass123" "0123456789abcdef"
快速搭本地靶场(Docker + Tomcat):
mkdir -p lab
# 用 generate_shell 生成 lab/shell.jsp(密码 pass123 / 密钥 0123456789abcdef)
docker run -d --name gz-lab -p 127.0.0.1:18080:8080 \
-v "$PWD/lab:/usr/local/tomcat/webapps/gz" tomcat:9.0-jdk8-temurin
python3 test/smoke_test.py "http://127.0.0.1:18080/gz/shell.jsp" "pass123" "0123456789abcdef"
变更记录(摘要)
- v1.4.0:工具集 50 → 56,Windows/.NET 补全(
mimikatz/petit_potam/shellcode_load/windows_privesc/sharp_web/csharp_memory_shell);zip/port_scan/real_cmd增加 C# 载荷分支;新增 Windows 启动脚本(run-http.bat/run-stdio.bat)。 - v1.3.0:工具集 44 → 50,
real_cmd虚拟终端(PHP/Java/C#)与 5 个 PHP 专属工具(php_ps/php_webshell_scan/php_bypass_open_basedir/php_bypass_disable_functions/php_attack_fpm);会话凭据原位重建与错误可读性修复。 - v1.2.2:修复 HTTP 模式未初始化核心注册表(连接类工具不可用);启动日志如实显示绑定地址;macOS 默认隐藏 Dock 图标。
- v1.2.1:
generate_shell全系生成(14 种 cryption,与核心生成器逐字节一致);get_env_config实时读取注册表。 - v1.2.0:工具集 10 → 44(会话/文件/大文件/内存马/端口扫描/插件库管理等);改用 Maven Central 编译依赖;CI 自动构建与发布;新增
scripts/plugin.py(VPS 插件管理)。 - v1.1.0:无头启动器 + stdio 传输;
generate_shell;修复ApplicationContext未初始化 NPE、util.Log污染 stdio、密钥派生、read_file接口。
完整记录见 CHANGELOG.md。
常见问题
Q:一定要安装哥斯拉吗? 不需要。只需要它的 godzilla.jar 与你的 data.db 两个文件。
Q:stdio 模式的进程"退出"了? stdio 服务器跟随客户端生命周期,属正常设计;需要常驻请用 HTTP 模式。
Q:Linux 无显示环境跑不起来? 装 xvfb(apt install xvfb)即可,脚本在无 DISPLAY 时自动改用 xvfb-run(原因:哥斯拉核心初始化会读取屏幕尺寸)。
Q:macOS 下跑 stdio/HTTP 会闪出 java 的 Dock 图标? 哥斯拉核心初始化会读取屏幕尺寸并触发 AWT 注册(不是启动 GUI);v1.2.2 起启动脚本在 macOS 默认附加 -Dapple.awt.UIElement=true,Dock 图标不再出现且功能不受影响;自定义 JVM 参数可用 JAVA_OPTS 环境变量。
Q:会和哥斯拉 GUI 冲突吗? 可共用同一个 data.db(读互不影响);避免两边同时写入(如同时 add_shell)。
Q:exec_code 报 "no load"? 目标 PHP 需要 output_buffering > 0(发行版默认满足;CLI 内置服务器用 -d output_buffering=4096 启动)。
致谢
- BeichenDream/Godzilla — 哥斯拉本体
- cns1rius/godzilla-mcp — MCP 插件原始版本
- hkdonline/Godzilla-MCP — 本项目的直接上游
// faq
What is Godzilla-MCP-Headless?
哥斯拉 MCP 无头版:不启动哥斯拉 GUI,直接用 stdio/HTTP 驱动你的 Webshell(生成马 / 命令执行 / 文件管理),兼容 Claude Desktop、Claude Code、Cursor 等 MCP 客户端。基于 hkdonline/Godzilla-MCP 改版。. It is open-source on GitHub.
Is Godzilla-MCP-Headless free to use?
Godzilla-MCP-Headless is open-source, so it is free to use.
What category does Godzilla-MCP-Headless belong to?
Godzilla-MCP-Headless is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/godzilla-mcp-headless)
// retro hit counter
[](https://claudeers.com/godzilla-mcp-headless)
// reviews
// guestbook
// related in MCP Servers
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman
An open-source AI agent that brings the power of Gemini directly into your terminal.