Super Shell MCP

Super Shell MCP Server是一個跨平臺的MCP協議服務器，用於安全執行和管理多平臺Shell命令，提供命令白名單和審批機制。

開發者工具安全 #Shell執行 #跨平臺 #命令管理 #安全協議本地 .TypeScript

評分 : 2.5分

下載量 : 18

更新時間 : 2025-04-29

什麼是超級Shell MCP服務器？

超級Shell MCP服務器是一個用於在Windows、macOS和Linux上執行Shell命令的安全工具。它通過內置的審批機制確保命令執行的安全性。

如何使用超級Shell MCP服務器？

只需安裝並啟動服務器，然後通過客戶端配置即可開始使用。支持多種Shell和命令白名單管理。

適用場景

適用於需要在多平臺上安全執行命令的場景，例如開發、測試和自動化任務。

主要功能

跨平臺支持支持Windows、macOS和Linux系統，自動檢測平臺並選擇合適的Shell。

命令白名單管理支持安全、需要批准和禁止三種命令級別，可根據需求自定義白名單。

非阻塞審批流程潛在危險命令會進入待處理隊列，等待管理員批准後再執行。

全面日誌記錄記錄所有操作和命令執行情況，方便調試和監控。

豐富的命令管理工具提供添加、更新、刪除和獲取命令白名單的功能。

優勢與侷限性

優勢

支持多平臺統一管理

強大的安全性保障

易於擴展和定製

全面的日誌記錄

侷限性

初次配置可能稍顯複雜

依賴於客戶端支持MCP協議

如何使用

安裝服務器

通過NPM或本地安裝方式快速部署服務器。

啟動服務器

運行命令啟動服務器，監聽來自客戶端的請求。

配置客戶端

在Roo Code或Claude Desktop中配置MCP客戶端。

測試命令執行

通過客戶端發送命令請求，驗證服務器是否正常工作。

使用案例

獲取平臺信息獲取當前運行環境的平臺信息，包括操作系統和Shell版本。

執行簡單命令執行一個簡單的目錄列表命令。

添加命令到白名單將特定命令添加到白名單中。

常見問題

如何安裝超級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.