Dynamic Shell Server

Dynamic Shell Command MCP サーバー

ユーザー承認と監査ログによってセキュリティを維持しながら、シェルコマンドを安全に実行できる Model Context Protocol（MCP）サーバーです。このサーバーでは、任意のコマンドを実行できます。

特長

• 🔐 動的なコマンド承認システム
• 📝 承認済みコマンドの永続的な保存
• 📊 包括的な監査ログ
• ⏱️ コマンドのタイムアウト保護
• 🔄 コマンドの承認取り消し機能

インストール

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：シェルコマンドを実行します

   • パラメーター：
     • command：実行するコマンド
     • args：コマンド引数のオプションリスト

2. revoke_command_approval：以前に承認したコマンドの承認を取り消します

   • パラメーター：
     • command：承認を取り消すコマンド

利用可能なリソース

1. commands://approved：承認済みコマンドとその承認日を一覧表示します

データの保存

サーバーはデータを ~/.config/mcp-shell-server/ に保存します：

• approved_commands.json：承認済みコマンドとその承認日の一覧
• audit.log：すべてのコマンドの詳細な実行履歴

セキュリティ機能

• コマンドを初めて実行する際にユーザーの承認が必要
• 承認済みコマンドの永続的な保存
• 包括的な監査ログ
• コマンドのタイムアウトは5分
• シェルを実行しない（インジェクション攻撃を防止）
• コマンドの承認取り消し機能

使用例

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]