zgsfsec/vshell_mcp

This page was translated automatically. Technical details may differ from the original. View the original

21 stars 4 forks Quality 57 Trend 18

Overview

It encapsulates the command control, file management, tunnel proxy, listening management, client generation, and other capabilities of , allowing AI to directly operate any managed host on the platform. - : View current connection configuration (URL/account), logged-in user, server version and authorization - : Number of client/listen/agent, number of onlines, CPU/memory/disk/load, bandwidth, TCP/UDP connection count - : List all managed hosts (online/offline, system, IP, user, location) - : Execute shell commands on any host (supports pipes/redirect/workdir/timeout) - : Column directory, read and write files, create/delete/rename, upload/download, URL download (wget) - : Add, delete, modify, and search tunnel/proxy, enable/disable and change notes - : View and add new listeners (as needed** features) - : Generate and download clients (stage reverse / listen forward / stageless / shellcode / dll / ebpf, etc.) - : Reuses the v_shell management console terminal WebSocket (/api/terminal/ws). Each command opens an interactive shell once, first using stty -echo to disable echo and fixed prompts, then using MCPB_* / MCPD_* to uniquely tag and sandwich commands, returning pure stdout. - : Directly calls v_shell's /api/file/ and /api/tunnel/ HTTP interfaces. - : Logs in with account and password at startup to obtain JWT (Token: request header); after expiration, login automatically restores. - Go 1.24+ (only required during build; Runs only require precompiled binaries) - Running machines can access the v_shell platform's web address (HTTP/HTTPS both supported) *: If -token is set, account and password can be saved; Otherwise, -p is required (-u defaults to admin). ⚠️ -h is bound to v_shell ** parameter (not help); To view help, please use -help. When the MCP service is running on another machine, enter the address and port of that machine in the URL; If -mcpurl is enabled, enter the address generated by it. General explanation: host_id is the host ID in 'Client Management' (see list_hosts); local_path and other local paths refer to the path of . - This is a powerful tool; please only use it on v_shell platforms you have management privileges on. - get_server_info will return the login password to the AI client as is.

Overview (machine translated)

Package the **v_shell Management Platform’s command control, file management, tunnel proxy, listening management, client generation, and other capabilities into MCP Server (SSE Transfer), allowing AI to directly operate any managed host on the platform.

✨ Functional Features

Server Information: View current connection configuration (URL/account), logged-in user, server version, and authorization
Dashboard Metrics: Number of clients/listeners/agents, number of online accounts, CPU/memory/disk/load, bandwidth, TCP/UDP connections
Host Management: List all managed hosts (online/offline, system, IP, user, location)
Command Control: Execute shell commands on any host (supports pipes/redirects/workdir/timeouts)
File Management: column directories, read and write files, create/delete/rename, upload/download, URL download (wget)
Tunnel Agent: Add, delete, modify, query, enable/disable tunnel/proxy access, change notes
Listening Management: View and add listeners (delete function not provided as needed)
Client Generation: Generate and download clients (stage reverse / listen forward / stageless / shellcode / dll / ebpf, etc.)

A total of 27 tools, all verified end-to-end by the official MCP SDK and real v_shell instances.

Working Principle

Command Control: Reuses the terminal WebSocket (/api/terminal/ws) of the v_shell management console. Each command opens an interactive shell once, First, disable the echo and fix the prompt with stty -echo, then use the MCPB_* / MCPD_* unique marker grip command to return a pure stdout.
File/Tunnel: Directly calls v_shell’s /api/file/*, /api/tunnel/* HTTP interfaces.
Authentication: At startup, log in with account and password to obtain JWT (Token: request header); upon expiration, you will automatically log in again.

Environmental Requirements

Go 1.24+ (only required for build; Runtime only requires a pre-compiled binary)
The running machine can access the v_shell platform’s web address (HTTP/HTTPS is acceptable)

Build

Configuration and Startup

All configured via command-line parameters, no environment variables required:

Parameter	Required	Default	Description
`-h`	✅	-	v_shell Web console address, such as `http://your-vshell-server:8082`
`-u`	⭕*	`admin`	Log in to your account
`-p`	⭕*	-	Login password
`-token`	⭕	-	Preset JWT, then skip account and password login

This page was translated automatically. Technical details may differ from the original.

Install

This server does not publish a one-line install command.

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →

Configuration

{
  "mcpServers": {
    "vshell": {
      "type": "sse",
      "url": "http://127.0.0.1:19080/sse"
    }
  }
}