Super Shell MCP Server

基本能力

产品定位

Super Shell MCP Server 是一个跨平台的Shell命令执行服务，专注于提供安全、可控的命令执行环境。

核心功能

• 跨平台命令执行：支持Windows、macOS和Linux系统
• 自动平台检测和Shell选择：自动识别平台并选择合适的Shell
• 多Shell支持：
• Windows: cmd.exe, PowerShell
• macOS: zsh, bash, sh
• Linux: bash, sh, zsh
• 命令白名单：
• 安全级别分类：安全命令、需要审批的命令、禁止执行的命令
• 平台特定的命令白名单
• 非阻塞审批工作流：对潜在危险命令进行审批
• 全面的日志系统：文件日志记录
• 命令管理工具：提供丰富的命令管理功能
• 平台信息工具：用于诊断

适用场景

• 需要安全执行Shell命令的开发环境
• 跨平台自动化脚本执行
• 需要审批流程的命令执行场景
• 开发工具集成

工具列表

1. get_platform_info：获取当前平台和Shell信息
2. execute_command：在当前平台执行Shell命令
3. get_whitelist：获取白名单命令列表
4. add_to_whitelist：添加命令到白名单
5. update_security_level：更新白名单命令的安全级别
6. remove_from_whitelist：从白名单移除命令
7. get_pending_commands：获取待审批命令列表
8. approve_command：审批待执行命令
9. deny_command：拒绝待执行命令

常见问题解答

• 跨平台问题：
• Windows PowerShell脚本执行策略问题
• Windows路径分隔符问题
• 命令未找到问题
• Shell检测问题：服务器无法检测正确的Shell
• 命令执行超时：命令执行时间过长
• 白名单管理：需要添加自定义命令到白名单

使用教程

使用依赖

• Node.js环境
• Git（手动安装时需要）

安装教程

通过Smithery安装

npx -y @smithery/cli install @cfdude/super-shell-mcp --client claude

手动安装

git clone https://github.com/cfdude/super-shell-mcp.git
cd super-shell-mcp
npm install
npm run build

调试方式

启动服务器

npm start

或

node build/index.js

查看日志

# 查看完整日志
cat logs/super-shell-mcp.log

# 实时跟踪日志更新
tail -f logs/super-shell-mcp.log

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。