Mac Shell MCP 服务器

简介

Mac Shell MCP 服务器是一个为 macOS 提供增强 shell 功能的工具，通过集成 MCP（Multi-Command Protocol） 来实现对 shell 命令的安全管理和控制。

功能

该服务器提供了以下主要功能：

1. 命令分类管理：将 shell 命令分为三类——安全使用、需要批准使用和禁止使用。
2. 审批机制：为高风险命令提供审批流程，确保只有经过授权的命令才能执行。
3. 权限控制：所有命令均以运行服务器的用户权限执行，防止 privilege escalation 攻击。
4. 命令排队：待批准命令会被暂存，直到被明确批准或拒绝。

安装

1. 克隆项目仓库：

   git clone https://github.com/cfdude/mac-shell-mcp.git
   cd mac-shell-mcp
   

2. 安装依赖并构建：

   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
}

自定义安装

1. 安装为 npm 包：

   npm install -g mac-shell-mcp
   

2. 添加到 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 包管理器"
}

安全注意事项

1. 所有命令均以运行服务器的用户权限执行。
2. 需要批准的命令会被暂存，直到被明确批准或拒绝。
3. 禁止使用的命令将直接被拦截并显示错误信息。

项目链接

• GitHub 仓库
• MCP 协议文档