Secure Command Executor MCP Server

セキュアコマンド実行 MCP サーバー

日次ログローテーション機能を備えた堅牢なコマンド実行 MCP サービスです。安全性チェックとログ記録により、システムコマンドを安全に管理、実行できるよう設計されています。また、この README.md は DeepSeek V3 によって作成されています。

機能

• コマンド実行：オプションの引数を指定してシステムコマンドを実行します。
• 安全性チェック：危険なコマンドに対して警告を表示し、確認を求めます。
• コマンド管理：コマンドの追加、更新、削除、有効化、無効化を行います。
• ログ記録：詳細な操作履歴を記録し、ログを日次でローテーションします。
• クエリツール：フィルターを使って、利用可能なコマンドやログを検索します。

インストール

1. リポジトリをクローンします。

   git clone https://github.com/HappyAny/secure-command-executor-mcp-server.git
   cd secure-command-executor-mcp-server
   

2. 依存関係をインストールします。

   npm install minimist
   npm install @modelcontextprotocol/sdk
   npm install zod
   

3. サービスを設定します。

   • commands.json を編集して、利用可能なコマンドを定義します。
   • 環境変数を設定します（任意）。

使用方法

サービスの起動

node index.js --file commands.json --logs logs --port 3000

MCP の設定

{
    "mcpServers": {
        "cmd-exec": {
          "command": "node",
          "args": [
            "path_to_file/index.js",
            "--file",
            "path_to_file/commands.json",
            "--logs",
            "path_to_dict/logs"
          ]
        }
    }
}

コマンドファイル

commands.json ファイルで利用可能なコマンドを定義します。例：

[
  {
    "name": "dir",
    "description": "List directory contents",
    "example": "dir /w",
    "dangerous": false,
    "enabled": true,
    "confirmationPrompt": "",
    "consequences": ""
  },
  {
    "name": "format",
    "description": "Format disk drive",
    "example": "format C:",
    "dangerous": true,
    "enabled": false,
    "confirmationPrompt": "This will PERMANENTLY erase all data. Confirm?",
    "consequences": "Permanent data loss"
  }
]

API エンドポイント

コマンドの実行

curl -X POST http://localhost:3000/execute -H "Content-Type: application/json" -d '{"command": "dir", "args": "/w"}'

コマンドの検索

curl -X GET http://localhost:3000/queryCommands?filter=enabled&detailed=true

コマンドの管理

curl -X POST http://localhost:3000/manageCommand -H "Content-Type: application/json" -d '{"action": "add", "name": "ping", "description": "Test network connection", "example": "ping example.com"}'

ログの検索

curl -X GET http://localhost:3000/queryLogs?limit=50&filter=failed

設定

• 環境変数：

  • NODE_ENV：本番モードでは production に設定します。
  • PORT：デフォルトのポート（3000）を変更します。

• コマンドライン引数：

  • --file：コマンドファイルのパス（デフォルト：commands.json）。
  • --logs：ログディレクトリのパス（デフォルト：logs）。
  • --port：サービスを実行するポート（デフォルト：3000）。

ログ記録

ログは指定されたディレクトリに保存され、日次でローテーションされます。各ログファイルの名前は YYYY-MM-DD.json です。

コントリビューション

プルリクエストを歓迎します。大きな変更を行う場合は、まず issue を開き、変更内容について相談してください。

ライセンス

MIT