ShellGate MCP
Provides tools for managing Docker on the host: listing containers, viewing container logs, checking resource stats, and restarting containers. Arguments are passed without going through a shell.
Allows remote control of a Linux/WSL2 machine: executing shell commands, running and managing background jobs, reading/writing/editing files, listing directories, regex-searching files, and retrieving system info (kernel, load, memory, disk).
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ShellGate MCP
让 AI 客户端(任何支持远程 MCP 的客户端)通过 Streamable HTTP + Bearer Token 安全地远程管理设备:执行命令、后台任务、读写文件。服务端不带模型、不需要 API key;令牌只在本地生成,仓库与 Release 不含任何令牌。
按使用场景分成三个版本,各自独立的功能、默认配置、文档和发布标签,共用同一套核心代码(鉴权、确认码、输出脱敏、审计),不是同一程序复制三份。
版本 | 场景 | 平台 | 特有功能 | 配置样例 | 发布标签 |
路由器、软路由 | aarch64 / armv7 / x86_64 musl 静态 | uci、opkg、防火墙等危险命令确认;procd 服务;体积最小(无 HTTPS 下载、无桌面工具) |
| ||
U 盘 PE 救援、装机、修复 | Windows x64 / x86(WinPE、已装系统),附救援 Linux 静态版 | Ventoy 管理、桌面截图与键鼠、装机修复脚本、自建 PE、局域网 / 隧道模式 |
| ||
日常主机、WSL2 | Python 3.10+,systemd 用户服务 | Docker 工具、ripgrep 搜索、与 Windows 互通 |
|
目录
core/ Rust 核心(OpenWrt 版与 PE 版共用),按 cargo feature 组合功能
editions/openwrt/ OpenWrt 版:安装脚本、procd 服务、配置样例、文档
editions/pe/ PE 维护版:自建 PE(pe-build/)、第三方 PE 自启模板(pe-autostart/)、配置样例、文档
editions/wsl/ WSL2/Linux 版:Python 包、systemd 单元、安装脚本、文档
tests/ 共用的 MCP 一致性测试(Python 版与 Rust 二进制都跑同一套)Related MCP server: Remote Host MCP
Rust 核心的编译开关
feature | 含义 |
| 路由器版:通用工具 + |
| = |
| = |
默认(不加参数) | 全部功能,用于测试 |
cd core
cargo zigbuild --release --no-default-features --features edition-openwrt --target aarch64-unknown-linux-musl
cargo zigbuild --release --no-default-features --features edition-pe --target x86_64-pc-windows-gnusystem_info 与 MCP initialize 的返回里带 edition 字段,可确认跑的是哪个版本。
v0.4 新增工具(Rust 核心;带 * 的 Python 版也有)
工具 | 作用 | 平台 |
| 分块(每块 ≤1 MB)传二进制文件,sha256 整体校验后才替换目标,可续传;文本文件只能走会脱敏的 | 全部 |
| 只允许 | Linux |
| 普通用户运行时,第一次弹一次 UAC,之后经管理员助手进程执行 | Windows |
| 改配置自动回滚:先备份文件再执行,超时未确认就恢复文件并重载;ShellGate 重启或整机重启后仍会回滚。OpenWrt 默认备份 network/firewall/wireless/dhcp | 全部(为 OpenWrt 设计) |
| Linux 桌面:grim/import/scrot 截图,xdotool(或 ydotool)键鼠,wmctrl 窗口;需 | Linux |
服务态桌面 | ShellGate 以服务(session 0)运行时,桌面工具自动交给在用户会话里启动的副本执行 | Windows |
| 读屏幕控件树、截图(安卓 11+)、点按/滑动/输入、返回/主页等;需在系统无障碍里打开「ShellGate 屏幕控制」 | Android |
确认码现在只看真正执行的命令:grep reboot、cat /etc/passwd 这类只读命令的参数不再触发;管道喂给 sh/ssh、$(...)、xargs rm 等照样拦。
发布
每个版本单独打标签、单独发布:openwrt-v0.4.0、pe-v0.4.0(版本号取 core/Cargo.toml),wsl-v0.2.8(取 editions/wsl/pyproject.toml 与 __init__.py)。标签与版本号不一致时发布会失败。
许可
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.
Linux server administration over OAuth MCP: shell, Docker, systemd, files and monitoring.
Let AI operate servers without SSH. Choose actions, approve risky changes, and audit every step.
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables ChatGPT to securely inspect and administer a Linux VPS over Streamable HTTP, with OAuth protection, workspace file tools, and optional root command execution.MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI-controlled administration of remote Linux hosts and containers, including bounded shell execution, persistent PTY sessions, durable jobs/tasks, hardened filesystem access, process/service control, and resumable transfers.-
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to remotely execute shell commands and transfer files on SSH hosts, including jump-host tunneling, background tasks, resumable transfers, and optional approval of destructive commands, while SSH credentials remain in the local process. It runs over stdio or a streamable HTTP daemon and supports auditing, allow/deny lists, and multiple authentication methods.ISC
- AlicenseNot gradedqualityCmaintenanceEnables ChatGPT and MCP clients to safely inspect and operate a Linux host through OAuth-protected, workspace-bounded file, Git, process, systemd, and Docker diagnostics, plus human-approved edits and operations.MIT