### config.yaml Configuration Structure

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

Example structure for the config.yaml file. Ensure you replace the placeholder values with your actual connection information.

```yaml
server:
  port: 9123              # MCP HTTP 服务端口
  auth:
    enable: false         # 是否启用 MCP 认证
    password: ""
mcp:
  enable: true            # 是否启动 MCP 服务
database:                 # 团队 PostgreSQL（仅团队模式使用）
  host: 127.0.0.1
  port: 5432
  database: gsl5
  username: gsl5
  password: <your-password>
```

--------------------------------

### Start MCP Headless Mode

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

Launch the application in MCP headless mode to enable HTTP/SSE services for remote AI assistant access.

```bash
java -jar gsl5.jar mcp [port] [bindHost]
```

--------------------------------

### Codex MCP Configuration

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

Example configuration for Codex to connect to the GodzillaSuper MCP server via SSE.

```toml
[mcp_servers.gsl5]
type = "sse"
url = "http://127.0.0.1:9123/sse"
```

--------------------------------

### Claude MCP Configuration

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

Example configuration for Claude Desktop or Claude Code to connect to the GodzillaSuper MCP server via SSE.

```json
{
  "mcpServers": {
    "gsl5": {
      "type": "sse",
      "url": "http://127.0.0.1:9123/sse"
    }
  }
}
```

--------------------------------

### Compilation and Packaging Commands

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

Steps to compile the core source code, the MCP service, and package the final JAR file.

```bash
# 1) 编译核心源码（GBK）
javac -encoding GBK -cp "lib/*;bin/*" -d out/production/gsl5 \
  src/core/**/*.java src/shells/**/*.java src/util/**/*.java

# 2) 编译 MCP 服务（UTF-8，依赖已编译的核心）
javac -encoding UTF-8 -cp "lib/*;bin/*;out/production/gsl5" \
  -d out/production/gsl5 src/shells/plugins/generic/McpService.java

# 3) 打包
cd out/production/gsl5 && jar cf gsl5.jar *
```

--------------------------------

### CLI 启动 MCP 服务

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

通过命令行启动 MCP 服务，可指定端口和绑定地址。

```APIDOC
## CLI 启动 MCP 服务

### Description
通过命令行启动 MCP 服务，可指定端口和绑定地址。

### Command
java -jar gsl5.jar mcp [port] [bindHost]

### Parameters
- **port** (integer) - Optional - 服务端口，默认 9123
- **bindHost** (string) - Optional - 绑定地址，支持 host:port 写法，默认 0.0.0.0

### Example
java -jar gsl5.jar mcp 9123 127.0.0.1
```

--------------------------------

### MCP 工具 shell_create

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

生成 Shell 文件，可指定加密、生成文件、C2 配置和混淆选项。

```APIDOC
## MCP 工具 shell_create

### Description
生成 Shell 文件，可指定加密、生成文件、C2 配置和混淆选项。

### Tool
shell_create

### Parameters
- **cryption** (string) - Optional - 加密方式
- **genFile** (string) - Optional - 生成文件路径
- **c2Profile** (string) - Optional - C2 配置标识
- **obfuscation** (string) - Optional - 混淆方式，默认 default（不启用增强）
```

--------------------------------

### Typical MCP Workflow

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

A standard sequence of operations for using the GodzillaSuper MCP service.

```text
1. 启动 GSL5 MCP 服务（GUI 面板或 mcp 无头）
2. 写入 Claude / Codex 配置并连接 SSE
3. shell_list / shell_detect_encoding → 查看 Shell 并校正编码
4. shell_exec          → 在目标执行命令
5. file_list/file_read → 浏览、读取文件
6. db_exec             → 查询数据库
7. oplog_query         → 回溯操作审计
```

--------------------------------

### MCP 工具 settings_get / settings_set

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

读取或修改应用设置。

```APIDOC
## MCP 工具 settings_get / settings_set

### Description
读取或修改应用设置。

### Tools
- settings_get
- settings_set

### Parameters
- **key** (string) - Required - 设置键
- **value** (string) - Optional - 设置值
```

--------------------------------

### MCP 工具 config_read / config_write

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

读取或写入 config.yaml 配置。

```APIDOC
## MCP 工具 config_read / config_write

### Description
读取或写入 config.yaml 配置。

### Tools
- config_read
- config_write

### Parameters
- **content** (string) - Optional - 配置内容（写入时）
```

--------------------------------

### 启动 GodzillaSuper GUI

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

使用 Java 运行 jar 文件以启动图形用户界面。启动后需选择数据源以进入主界面。

```bash
java -jar bin/gsl5.jar
```

--------------------------------

### MCP 工具 process_list

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

列出远程进程。

```APIDOC
## MCP 工具 process_list

### Description
列出远程进程。

### Tool
process_list

### Parameters
- **id** (string) - Required - Shell 标识
```

--------------------------------

### MCP 工具 shell_info

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

获取远程系统信息（OS / 用户 / 目录）。

```APIDOC
## MCP 工具 shell_info

### Description
获取远程系统信息（OS / 用户 / 目录）。

### Tool
shell_info

### Parameters
- **id** (string) - Required - Shell 标识
```

--------------------------------

### Git Tag Checkout Commands

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

Commands to switch between specific release tags and the main development branch.

```bash
git checkout 3.1.5    # 切到 3.1.5 发布源码，按下文步骤编译打包
git checkout main     # 回到最新开发源码
```

--------------------------------

### MCP 工具 shell_env

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

读取或设置 Shell 环境变量。

```APIDOC
## MCP 工具 shell_env

### Description
读取或设置 Shell 环境变量。

### Tool
shell_env

### Parameters
- **id** (string) - Required - Shell 标识
- **name** (string) - Optional - 环境变量名
- **value** (string) - Optional - 环境变量值
```

--------------------------------

### MCP 工具 db_exec

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

执行 SQL 查询。

```APIDOC
## MCP 工具 db_exec

### Description
执行 SQL 查询。

### Tool
db_exec

### Parameters
- **sql** (string) - Required - SQL 语句
```

--------------------------------

### MCP 工具 file_delete / file_copy / file_move

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

删除、复制或移动远程文件。

```APIDOC
## MCP 工具 file_delete / file_copy / file_move

### Description
删除、复制或移动远程文件。

### Tools
- file_delete
- file_copy
- file_move

### Parameters
- **id** (string) - Required - Shell 标识
- **path** (string) - Required - 源路径
- **dest** (string) - Required for copy/move - 目标路径
```

--------------------------------

### MCP 工具 db_list_types / db_configs

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

列出支持的数据库类型或管理连接配置。

```APIDOC
## MCP 工具 db_list_types / db_configs

### Description
列出支持的数据库类型或管理连接配置。

### Tools
- db_list_types
- db_configs
```

--------------------------------

### MCP 工具 file_list

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

列出远程目录内容。

```APIDOC
## MCP 工具 file_list

### Description
列出远程目录内容。

### Tool
file_list

### Parameters
- **id** (string) - Required - Shell 标识
- **path** (string) - Required - 目录路径
```

--------------------------------

### MCP 工具 oplog_query

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

查询团队操作日志。

```APIDOC
## MCP 工具 oplog_query

### Description
查询团队操作日志。

### Tool
oplog_query

### Parameters
- **filter** (object) - Optional - 查询过滤条件
```

--------------------------------

### MCP 工具 file_upload_local / file_download_local

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

本机路径直传或直存，不经 AI 中转。

```APIDOC
## MCP 工具 file_upload_local / file_download_local

### Description
本机路径直传或直存，不经 AI 中转。

### Tools
- file_upload_local
- file_download_local

### Parameters
- **id** (string) - Required - Shell 标识
- **localPath** (string) - Required - 本机路径
- **remotePath** (string) - Required - 远程路径
```

--------------------------------

### MCP 工具 payload_list

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

列出所有载荷与加密器（含 NetCore）。

```APIDOC
## MCP 工具 payload_list

### Description
列出所有载荷与加密器（含 NetCore）。

### Tool
payload_list
```

--------------------------------

### MCP 工具 shell_backup

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

备份 Shell 列表。

```APIDOC
## MCP 工具 shell_backup

### Description
备份 Shell 列表。

### Tool
shell_backup
```

--------------------------------

### MCP 工具 file_mkdir / file_attr

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

创建目录或设置文件属性（权限 / 时间戳）。

```APIDOC
## MCP 工具 file_mkdir / file_attr

### Description
创建目录或设置文件属性（权限 / 时间戳）。

### Tools
- file_mkdir
- file_attr

### Parameters
- **id** (string) - Required - Shell 标识
- **path** (string) - Required - 路径
- **permissions** (string) - Optional - 权限设置
- **timestamp** (string) - Optional - 时间戳设置
```

--------------------------------

### 启动 MCP 无头模式

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

通过命令行启动 MCP 无头模式以支持 AI 操控。支持自定义端口和绑定地址，配置完成后可在 Claude 或 Codex 中使用。

```bash
java -jar bin/gsl5.jar mcp                 # 默认 0.0.0.0:9123
java -jar bin/gsl5.jar mcp 9999            # 自定义端口（仍绑 0.0.0.0）
java -jar bin/gsl5.jar mcp 9999 127.0.0.1  # 端口 + 绑定地址
java -jar bin/gsl5.jar mcp 0.0.0.0:9123    # host:port 写法
java -jar bin/gsl5.jar mcp 192.168.1.10:9123
```

--------------------------------

### MCP 工具 shell_exec

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

在目标上执行系统命令，支持指定编码。

```APIDOC
## MCP 工具 shell_exec

### Description
在目标上执行系统命令，支持指定编码。

### Tool
shell_exec

### Parameters
- **id** (string) - Required - Shell 标识
- **command** (string) - Required - 要执行的命令
- **encoding** (string) - Optional - 编码，支持 GBK/UTF-8/auto
```

--------------------------------

### MCP 工具 shell_batch_test

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

批量测试 Shell 连接。

```APIDOC
## MCP 工具 shell_batch_test

### Description
批量测试 Shell 连接。

### Tool
shell_batch_test
```

--------------------------------

### MCP 工具 shell_get

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

获取单个 Shell 的完整配置。

```APIDOC
## MCP 工具 shell_get

### Description
获取单个 Shell 的完整配置。

### Tool
shell_get

### Parameters
- **id** (string) - Required - Shell 的唯一标识
```

--------------------------------

### MCP 工具 net_info

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

获取网络连接信息。

```APIDOC
## MCP 工具 net_info

### Description
获取网络连接信息。

### Tool
net_info

### Parameters
- **id** (string) - Required - Shell 标识
```

--------------------------------

### MCP 工具 shell_export / shell_import

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

导出或导入 Shell（gsl5:// 链接）。

```APIDOC
## MCP 工具 shell_export / shell_import

### Description
导出或导入 Shell（gsl5:// 链接）。

### Tools
- shell_export
- shell_import

### Parameters
- **id** (string) - Required for export - Shell 标识
- **link** (string) - Required for import - gsl5:// 链接
```

--------------------------------

### MCP 工具 shell_test

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

测试单条 Shell 连接。

```APIDOC
## MCP 工具 shell_test

### Description
测试单条 Shell 连接。

### Tool
shell_test

### Parameters
- **id** (string) - Required - Shell 标识
```

--------------------------------

### MCP 工具 shell_clone

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

克隆一个 Shell。

```APIDOC
## MCP 工具 shell_clone

### Description
克隆一个 Shell。

### Tool
shell_clone

### Parameters
- **id** (string) - Required - 要克隆的 Shell 标识
```

--------------------------------

### Migrate SQLite to PostgreSQL

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

Use the migration tool to transfer data from a local SQLite database to a remote PostgreSQL instance.

```bash
java -cp gsl5.jar;lib/postgresql-*.jar core.MigrateDb [host] [port] [db] [user] [pass]
```

--------------------------------

### MCP 工具 file_search / file_roots

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

按名称搜索文件或列出文件系统根目录。

```APIDOC
## MCP 工具 file_search / file_roots

### Description
按名称搜索文件或列出文件系统根目录。

### Tools
- file_search
- file_roots

### Parameters
- **id** (string) - Required - Shell 标识
- **pattern** (string) - Required for file_search - 搜索模式
```

--------------------------------

### MCP 工具 mcp_config

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

生成或写入 Claude 或 Codex 配置。

```APIDOC
## MCP 工具 mcp_config

### Description
生成或写入 Claude 或 Codex 配置。

### Tool
mcp_config

### Parameters
- **client** (string) - Required - 目标客户端，可选 claude|codex|all
- **write** (boolean) - Required - 是否写入配置
- **host** (string) - Optional - 主机地址
- **outputPath** (string) - Optional - 输出路径
```

--------------------------------

### MCP 工具 shell_list

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

列出所有 Shell，可按分组过滤。

```APIDOC
## MCP 工具 shell_list

### Description
列出所有 Shell，可按分组过滤。

### Tool
shell_list

### Parameters
- **group** (string) - Optional - 分组过滤条件
```

--------------------------------

### MCP 工具 shell_add / shell_edit / shell_delete

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

新增、修改或删除 Shell。

```APIDOC
## MCP 工具 shell_add / shell_edit / shell_delete

### Description
新增、修改或删除 Shell。

### Tools
- shell_add
- shell_edit
- shell_delete

### Parameters
- **id** (string) - Required for edit/delete - Shell 标识
- **config** (object) - Required for add/edit - Shell 配置内容
```

--------------------------------

### MCP 工具 file_read

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

读取远程文件，自动判断文本或二进制。

```APIDOC
## MCP 工具 file_read

### Description
读取远程文件，自动判断文本或二进制。

### Tool
file_read

### Parameters
- **id** (string) - Required - Shell 标识
- **path** (string) - Required - 文件路径
```

--------------------------------

### MCP 工具 shell_search

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

按关键词搜索 Shell。

```APIDOC
## MCP 工具 shell_search

### Description
按关键词搜索 Shell。

### Tool
shell_search

### Parameters
- **keyword** (string) - Required - 搜索关键词
```

--------------------------------

### MCP 工具 shell_count

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

按分组统计 Shell 数量。

```APIDOC
## MCP 工具 shell_count

### Description
按分组统计 Shell 数量。

### Tool
shell_count

### Parameters
- **group** (string) - Optional - 分组过滤条件
```

--------------------------------

### MCP 工具 shell_detect_encoding

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

探测远程控制台编码并写回数据库。

```APIDOC
## MCP 工具 shell_detect_encoding

### Description
探测远程控制台编码并写回数据库。

### Tool
shell_detect_encoding

### Parameters
- **id** (string) - Required - Shell 标识
```

--------------------------------

### MCP 工具 c2profile_list / c2profile_get

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

列出或获取 C2 配置。

```APIDOC
## MCP 工具 c2profile_list / c2profile_get

### Description
列出或获取 C2 配置。

### Tools
- c2profile_list
- c2profile_get

### Parameters
- **id** (string) - Required for c2profile_get - C2 配置标识
```

--------------------------------

### MCP 工具 file_remote_down

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

从 URL 远程下载文件到目标。

```APIDOC
## MCP 工具 file_remote_down

### Description
从 URL 远程下载文件到目标。

### Tool
file_remote_down

### Parameters
- **id** (string) - Required - Shell 标识
- **url** (string) - Required - 下载 URL
- **dest** (string) - Required - 目标路径
```

--------------------------------

### MCP 工具 mcp_status

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

获取 MCP 服务状态（绑定地址 / 可访问 URL）。

```APIDOC
## MCP 工具 mcp_status

### Description
获取 MCP 服务状态（绑定地址 / 可访问 URL）。

### Tool
mcp_status
```

--------------------------------

### Update Single Class in JAR

Source: https://github.com/xaaaa-bip/godzillasuper/blob/main/README.md

Command to update a single class file within an existing JAR without performing a full rebuild.

```bash
jar uf out/artifacts/gsl5_jar/gsl5.jar shells/plugins/generic/McpService.class
```