Dynamic Shell Server

🚀 動態Shell命令控制檯服務器（MCP）

這是一個模型上下文協議（MCP）服務器，它能在保障安全的情況下執行任意shell命令。藉助動態審批系統，服務器可在允許運行任意命令的同時，通過用戶批准和審計日誌維護安全性。

🚀 快速開始

本服務器支持獨立運行模式和與Claude桌面集成兩種使用方式，下面為您詳細介紹。

獨立運行模式

1. 克隆此倉庫：

git clone <repository-url>
cd dynamic-shell-server

2. 創建虛擬環境並激活它：

python -m venv venv
source venv/bin/activate  # 在Windows系統中使用：venv\Scripts\activate

3. 安裝依賴項：

pip install -r requirements.txt

4. 直接運行服務器：

python dynamic_shell_server.py

與Claude桌面集成

1. 打開您的Claude桌面配置文件：
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. 添加服務器配置：

{
    "mcpServers": {
        "shell": {
            "command": "/absolute/path/to/.venv/bin/python",
            "args": ["/absolute/path/to/dynamic_shell_server.py"]
        }
    }
}

3. 重啟Claude桌面應用

✨ 主要特性

• 🔐 動態命令審批系統
• 📝 批准命令的持久化存儲
• 📊 詳盡的審計日誌記錄
• ⏱️ 命令超時保護機制
• 🔄 命令撤銷功能

💻 使用示例

基礎用法

以下是使用 execute_command 工具執行shell命令的示例：

# 假設我們要執行ls命令列出當前目錄下的文件
from some_module import execute_command
result = execute_command(command='ls', args=[])
print(result)

高級用法

使用 revoke_command_approval 工具撤銷之前批准的某個命令的權限：

# 假設我們要撤銷之前批准的ls命令
from some_module import revoke_command_approval
revoke_command_approval(command='ls')

📚 詳細文檔

命令審批流程

首次運行某個命令時，將會出現如下提示：

命令執行審批要求

命令: <command>
參數: <args>

此命令尚未被批准。您希望進行以下操作：
1. 允許本次執行
2. 批准並記住該命令以備將來使用
3. 拒絕執行

請選擇選項（1-3）：

可用工具

1. execute_command：執行shell命令
   • 參數：
     • command: 要執行的命令
     • args: 可選的命令參數列表
2. revoke_command_approval：撤銷之前批准的某個命令的權限
   • 參數：
     • command: 要撤銷的命令

資源訪問

1. commands://approved：列出所有已批准的命令及其批准日期

數據存儲位置

服務器的數據存儲在 ~/.config/mcp-shell-server/ 目錄下：

• approved_commands.json：記錄所有已批准的命令及其批准時間
• audit.log：詳細記錄所有執行過的命令的歷史日誌

🔧 技術細節

安全特性

• 用戶審批首次運行的未知命令
• 批准命令持久化存儲
• 詳盡的審計日誌記錄
• 命令超時保護（5分鐘）
• 防護shell注入攻擊
• 支持撤銷已批准的命令