🚀 Mac Shell MCP 服务器
Mac Shell MCP 服务器是一款专为 macOS 打造的工具，它通过集成 MCP（Multi-Command Protocol） 来增强 shell 功能，实现对 shell 命令的安全管理与控制。
🚀 快速开始
Mac Shell MCP 服务器能有效管理和控制 macOS 的 shell 命令，保障系统安全。下面为你介绍它的安装和使用方法。
✨ 主要特性
该服务器具备以下核心功能：
- 🧾 命令分类管理：将 shell 命令细致划分为安全使用、需要批准使用和禁止使用三类，方便用户管理。
- ✅ 审批机制：针对高风险命令设置审批流程，确保只有授权命令才能执行，提升系统安全性。
- 🔐 权限控制：所有命令均以运行服务器的用户权限执行，有效防止 privilege escalation 攻击。
- ⏳ 命令排队：待批准命令会被暂存，直至明确批准或拒绝，保证命令执行的有序性。
📦 安装指南
按照以下步骤完成项目的克隆、依赖安装和构建：
- 克隆项目仓库：
git clone https://github.com/cfdude/mac-shell-mcp.git cd mac-shell-mcp - 安装依赖并构建：
npm install npm run build
💻 使用示例
启动服务器
node build/server.js
配置指南
通过 npx 使用
将以下配置添加到 MCP 设置中：
对于 Brave Shell：
"mac-shell": {
"command": "npx",
"args": ["-y", "github:cfdude/mac-shell-mcp"],
"alwaysAllow": [],
"disabled": false
}
自定义安装
- 安装为 npm 包：
npm install -g mac-shell-mcp - 添加到 MCP 配置：
"mac-shell": { "command": "mac-shell-mcp", "alwaysAllow": [], "disabled": false }
📚 详细文档
默认配置
安全使用命令
ls- 列出目录内容pwd- 显示当前工作目录echo- 输出文本到标准输出cat- 查看文件内容grep- 在文件中搜索模式find- 搜索目录层次结构cd- 切换目录head- 输出文件开头部分tail- 输出文件结尾部分wc- 显示行、单词和字节数统计
需要批准的命令
mv- 移动或重命名文件cp- 复制文件和目录mkdir- 创建新目录touch- 更改文件时间戳或创建空文件chmod- 修改文件权限chown- 更改文件所有者和组
禁止使用的命令
rm- 删除文件或目录sudo- 以其他用户身份执行命令
扩展 whitelist
通过 MCP 工具 add_to_whitelist 可添加新的受信任命令，示例如下：
{
"command": "npm",
"securityLevel": "requires_approval",
"description": "Node.js 包管理器"
}
⚠️ 重要提示
- 所有命令均以运行服务器的用户权限执行。
- 需要批准的命令会被暂存，直到被明确批准或拒绝。
- 禁止使用的命令将直接被拦截并显示错误信息。