Mac Shell MCP 服务器

一个 MCP（模型上下文协议）服务器，用于使用 ZSH shell 执行 macOS 终端命令。该服务器通过内置的白名单和审批机制，提供了一种安全执行 shell 命令的方法。

特征

• 通过 MCP 执行 macOS 终端命令

• 具有安全级别的命令白名单：

  • 安全：无需批准即可执行的命令

  • 需要批准：执行前需要明确批准的命令

  • 禁止：明确阻止的命令

• 预先配置白名单，包含常用安全命令

• 潜在危险命令的审批工作流程

• 全面的命令管理工具

Related MCP server: Terminal MCP Server

安装

# Clone the repository
git clone https://github.com/cfdude/mac-shell-mcp.git
cd mac-shell-mcp

# Install dependencies
npm install

# Build the project
npm run build

用法

启动服务器

npm start

或者直接：

node build/index.js

在 Roo Code 和 Claude Desktop 中配置

Roo Code 和 Claude Desktop 的 MCP 服务器配置格式类似。以下是设置 Mac Shell MCP 服务器的方法：

使用本地安装

Roo 代码配置

将以下内容添加到您的 Roo Code MCP 设置配置文件（位于~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json ）：

"mac-shell": {
  "command": "node",
  "args": [
    "/path/to/mac-shell-mcp/build/index.js"
  ],
  "alwaysAllow": [],
  "disabled": false
}

Claude桌面配置

将以下内容添加到您的 Claude Desktop 配置文件（位于~/Library/Application Support/Claude/claude_desktop_config.json ）：

"mac-shell": {
  "command": "node",
  "args": [
    "/path/to/mac-shell-mcp/build/index.js"
  ],
  "alwaysAllow": false,
  "disabled": false
}

将/path/to/mac-shell-mcp替换为您克隆存储库的实际路径。

使用 NPX（推荐）

为了更方便的设置，不需要保持终端窗口打开，您可以将包发布到 npm 并与 npx 一起使用：

发布到 npm

1. 使用您的详细信息更新 package.json

2. 发布到 npm：

   npm publish

Roo 代码配置

"mac-shell": {
  "command": "npx",
  "args": [
    "-y",
    "mac-shell-mcp"
  ],
  "alwaysAllow": [],
  "disabled": false
}

Claude桌面配置

"mac-shell": {
  "command": "npx",
  "args": [
    "-y",
    "mac-shell-mcp"
  ],
  "alwaysAllow": false,
  "disabled": false
}

这种方法允许 MCP 客户端自动启动 MCP 服务器，而无需单独的终端窗口或手动干预。

笔记：

• 对于 Roo 代码：出于安全考虑，建议将alwaysAllow设置为空数组[] ，因为它会在执行任何命令之前提示您批准。如果您想允许特定命令而不提示，可以将这些命令的名称添加到数组中，例如： "alwaysAllow": ["execute_command", "get_whitelist"] 。

• 对于 Claude Desktop：出于安全考虑，建议alwaysAllow设置为false Desktop 使用布尔值而不是数组，其中false表示所有命令都需要批准， true表示所有命令均允许，无需提示。

重要提示： alwaysAllow参数由 MCP 客户端（Roo Code 或 Claude Desktop）处理，而非由 Mac Shell MCP 服务器本身处理。服务器无论使用哪种格式都能正常工作，因为客户端会在向服务器发送请求之前处理审批流程。

可用工具

该服务器公开以下 MCP 工具：

execute_command

在 macOS 上执行 shell 命令。

{
  "command": "ls",
  "args": ["-la"]
}

get_whitelist

获取白名单命令列表。

{}

add_to_whitelist

将命令添加到白名单。

{
  "command": "python3",
  "securityLevel": "safe",
  "description": "Run Python 3 scripts"
}

update_security_level

更新白名单命令的安全级别。

{
  "command": "python3",
  "securityLevel": "requires_approval"
}

remove_from_whitelist

从白名单中删除命令。

{
  "command": "python3"
}

get_pending_commands

获取待批准的命令列表。

{}

approve_command

批准待处理的命令。

{
  "commandId": "command-uuid-here"
}

deny_command

拒绝待处理的命令。

{
  "commandId": "command-uuid-here",
  "reason": "This command is potentially dangerous"
}

默认白名单命令

安全命令（无需批准）

• ls列出目录内容

• pwd打印工作目录

• echo将文本打印到标准输出

• cat连接并打印文件

• grep在文件中搜索模式

• find在目录层次结构中查找文件

• cd更改目录

• head输出文件的第一部分

• tail输出文件的最后部分

• wc打印换行符、字数和字节数

需要批准的命令

• mv移动（重命名）文件

• cp复制文件和目录

• mkdir创建目录

• touch更改文件时间戳或创建空文件

• chmod更改文件模式位

• chown更改文件所有者和组

禁止的命令

• rm删除文件或目录

• sudo以另一个用户身份执行命令

安全注意事项

• 所有命令均以运行 MCP 服务器的用户权限执行

• 需要批准的命令将被保留在队列中，直到明确批准

• 禁止的命令永远不会执行

• 服务器使用 Node.js 的execFile而不是exec来防止 shell 注入

• 指定时，根据允许的模式验证参数

扩展白名单

您可以使用add_to_whitelist工具扩展白名单。例如：

{
  "command": "npm",
  "securityLevel": "requires_approval",
  "description": "Node.js package manager"
}

用作 npm 包

要将 Mac Shell MCP 服务器与npx一起使用，类似于 Brave Search 等其他 MCP 服务器，您可以将其发布到 npm 或直接从 GitHub 使用它。

使用 npx 配置

将以下内容添加到您的 MCP 设置配置中：

罗奥代码

"mac-shell": {
  "command": "npx",
  "args": [
    "-y",
    "github:cfdude/mac-shell-mcp"
  ],
  "alwaysAllow": [],
  "disabled": false
}

克劳德桌面

"mac-shell": {
  "command": "npx",
  "args": [
    "-y",
    "github:cfdude/mac-shell-mcp"
  ],
  "alwaysAllow": false,
  "disabled": false
}

这将自动下载并运行服务器，而无需手动克隆和构建过程。

发布到 npm

如果你想将自己的版本发布到 npm：

1. 使用您的详细信息更新 package.json

2. 在 package.json 中添加“bin”字段：

   "bin": {
     "mac-shell-mcp": "./build/index.js"
   }

3. 发布到 npm：

   npm publish

然后您可以在 MCP 配置中使用它：

罗奥代码

"mac-shell": {
  "command": "npx",
  "args": [
    "-y",
    "mac-shell-mcp"
  ],
  "alwaysAllow": [],
  "disabled": false
}

克劳德桌面

"mac-shell": {
  "command": "npx",
  "args": [
    "-y",
    "mac-shell-mcp"
  ],
  "alwaysAllow": false,
  "disabled": false
}

执照

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。