Dynamic Shell Server

动态 Shell 命令 MCP 服务

一种模型上下文协议（MCP）服务，可通过动态审批系统安全地执行 Shell 命令。该服务允许运行任意命令，同时通过用户审批和审计日志确保安全。

功能

• 🔐 动态命令审批系统
• 📝 持久化存储已批准的命令
• 📊 全面的审计日志
• ⏱️ 命令超时保护
• 🔄 撤销命令审批的功能

安装

1. 克隆此代码库：

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

2. 创建并激活虚拟环境：

python -m venv venv
source venv/bin/activate  # On Windows use: venv\Scripts\activate

3. 安装依赖项：

pip install -r requirements.txt

用法

独立模式

直接运行服务：

python dynamic_shell_server.py

Claude Desktop 集成

1. 打开 Claude Desktop 配置文件：

   • 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 Desktop

命令审批流程

首次运行某条命令时，系统会提示：

Command Approval Required

Command: <command>
Arguments: <args>

This command has not been previously approved. Do you want to:
1. Allow this command once
2. Allow this command and remember for future use
3. Deny execution

Please choose an option (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（防止注入攻击）
• 撤销命令审批的功能

使用示例

通过 Claude Desktop：

Human: Run 'npm install' in my project directory
Assistant: I'll help you run that command. Since this is the first time running 'npm install', you'll need to approve it.
[Command approval prompt appears]