Super Shell MCP

Super Shell MCP Server是一个跨平台的MCP协议服务器，用于安全执行和管理多平台Shell命令，提供命令白名单和审批机制。

开发者工具安全 #Shell执行 #跨平台 #命令管理 #安全协议本地 .TypeScript

评分 : 2.5分

下载量 : 23

更新时间 : 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.