Permshell

🚀 殼權限 MCP 服務器

本項目是一個基於模型上下文協議 (MCP) 的服務器，主要用於帶有權限通知的殼命令執行。它能有效解決在執行殼命令時的權限管理問題，為用戶提供更安全、標準化的命令執行環境。

🚀 快速開始

本服務器可讓你在執行殼命令時進行權限管理。以下是快速搭建和使用該服務器的步驟。

✨ 主要特性

• 📢 通過 -growl 通知執行帶顯式權限的殼命令。
• 🛠️ 搭建在模型上下文協議上，實現標準化大語言模型工具。
• 🔒 多重保護措施防止未經授權的命令執行。
• 👀 權限對話框透明顯示將要執行的具體命令。

📦 安裝指南

# 克隆倉庫
git clone https://github.com/yourusername/perm-shell-mcp.git
cd perm-shell-mcp

# 安裝依賴項
npm install

# 構建項目
npm run build

💻 使用示例

基礎用法

作為獨立工具運行

# 直接啟動服務器
npm start

集成到 Claude Desktop

在你的 Claude Desktop 配置文件中添加以下內容：

{
  "mcpServers": {
    "permshell": {
      "command": "node",
      "args": ["/path/to/perm-shell-mcp/dist/index.js"]
    }
  }
}

高級用法

可用工具

execute-command

帶權限執行殼命令。 示例：

你能列出我的主目錄中的文件嗎？

system-info

獲取系統信息，包括操作系統、運行時間、內存、磁盤和 CPU 詳情。 示例：

我的系統信息是什麼？

⚠️ 重要提示

• 所有命令都需要通過桌面通知明確授權。
• 顯示工作目錄以實現完全透明。
• 超時限制防止進程無限制運行。
• 輸入淨化防止命令注入攻擊。

📚 詳細文檔

開發指南

# 開發模式下運行
npm run dev