Mac Shell MCP

🚀 Mac Shell MCP 服務器

Mac Shell MCP 服務器是一款專為 macOS 打造的工具，它通過集成 MCP（Multi-Command Protocol） 來增強 shell 功能，實現對 shell 命令的安全管理與控制。

🚀 快速開始

Mac Shell MCP 服務器能有效管理和控制 macOS 的 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 協議文檔