Super Shell MCP

🚀 超級殼（Super Shell）

超級殼（Super Shell）是一款強大的命令外殼工具，專為開發人員和系統管理員打造，能顯著提升工作效率。它支持 Windows、macOS 和 Linux 等多平臺，具備命令管理、權限控制、日誌記錄和遠程配置等豐富功能模塊。

🚀 快速開始

超級殼（Super Shell）支持跨平臺操作，能在 Windows、macOS 和 Linux 系統上運行。通過簡單的安裝和配置，即可開啟高效的命令操作之旅。

✨ 主要特性

• 命令管理：藉助黑白名單策略，可限制或允許特定命令執行，還能進行超時控制，防止長時間未響應的命令佔用系統資源。
• 權限控制：基於用戶角色和環境變量，提供靈活的權限管理，支持多種身份驗證方式，並可通過訪問控制列表（ACL）定義細粒度的資源訪問權限。
• 日誌系統：內置完善的日誌記錄功能，便於調試和監控服務器狀態。日誌文件默認存儲在 logs/super-shell-mcp.log，支持 INFO、DEBUG、ERROR 等多種日誌級別。
• 跨平臺支持：支持 Windows、macOS 和 Linux 操作系統，能根據不同系統自動適配 shell 類型。

📦 安裝指南

安裝

• 通過 npm 安裝：

npm install -g super-shell-mcp

• 手動安裝：將壓縮包解壓到指定目錄，並確保可執行文件具有正確的權限。

配置

超級殼可通過配置文件 config.json 進行個性化設置，以下是常用的配置選項：

{
  "shellType": "auto", // 自動檢測 shell 類型，支持 "cmd"、"bash" 和 "powershell"
  "timeout": 30000,    // 命令執行超時時間（毫秒）
  "whitelist": ["ls", "cd", "cp", "rm"], // 允許的命令列表
  "blacklist": ["sudo", "su"], // 禁止的命令列表
  "logLevel": "INFO" // 日誌級別：INFO、DEBUG、ERROR
}

💻 使用示例

基礎用法

配置 Shell

# 示例：配置超級殼使用 PowerShell 在 Windows 上運行
{
  "shellType": "powershell",
  "workingDirectory": "C:\\Users\\CurrentUser\\Documents"
}

執行命令

# 示例：執行簡單文件操作
super-shell-mcp.exe -c "ls" // 列出當前目錄下的文件
super-shell-mcp.exe -c "cd .." // 返回上一級目錄

🔧 技術細節

命令管理

超級殼提供強大的命令控制功能，通過 whitelist 和 blacklist 配置，可限制或允許特定的命令執行。同時，支持超時控制，防止長時間未響應的命令佔用系統資源。

權限控制

基於用戶角色和環境變量，超級殼提供靈活的權限管理。支持多種身份驗證方式（如令牌認證、OAuth），並通過訪問控制列表（ACL）定義細粒度的資源訪問權限。

日誌系統

超級殼內置了完善的日誌記錄功能，便於調試和監控服務器狀態。日誌文件默認存儲在 logs/super-shell-mcp.log，會自動創建日誌目錄，幷包含 .gitkeep 文件以跟蹤該目錄。支持 INFO、DEBUG、ERROR 等多種日誌級別。

跨平臺支持

超級殼支持 Windows、macOS 和 Linux 操作系統。在 Windows 上，可使用 cmd.exe 或 PowerShell 執行命令，注意路徑分隔符（反斜槓 \）需要在 JSON 中轉義為雙反斜槓 (\\)；在 macOS/Linux 上，默認使用 /bin/bash 或用戶指定的 shell。

📄 許可證

超級殼遵循 MIT 許可證協議：

MIT License

Copyright (c) [year] [copyright holder]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.