Dynamic Shell Server

🚀 動的シェルコマンドコンソールサーバー（MCP）

モデルコンテキストプロトコル（MCP）サーバーです。安全を保証しながら任意のシェルコマンドを実行でき、動的承認システムにより安全性を確保します。このサーバーは任意のコマンドの実行を許可し、ユーザーの承認と監査ログによって安全性を維持します。

✨ 主な機能

• 🔐 動的コマンド承認システム
• 📝 承認されたコマンドの永続的な保存
• 📊 詳細な監査ログ記録
• ⏱️ コマンドのタイムアウト保護機能
• 🔄 コマンドの取り消し機能

📦 インストール

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

💻 使用例

基本的な使用法

独立実行モード

サーバーを直接実行します：

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デスクトップアプリを再起動します

高度な使用法

コマンド承認フロー

初めてあるコマンドを実行すると、以下のようなプロンプトが表示されます：

コマンド実行承認要求

コマンド: <command>
引数: <args>

このコマンドはまだ承認されていません。次の操作を選択してください：
1. 今回の実行を許可する
2. 承認し、将来の使用のためにこのコマンドを記憶する
3. 実行を拒否する

選択肢（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分）
• シェルインジェクション攻撃からの保護
• 承認されたコマンドの取り消しをサポートします