Cmd Line MCP

🚀 コマンドラインツールセキュリティシステムドキュメント

本システムは強力なコマンドラインツールのセキュリティ機構を提供しています。厳格なディレクトリアクセス制御とコマンドの分類管理により、システムの安全性を保障することを目的としています。このシステムは3種類の異なるディレクトリアクセスモードをサポートし、ユーザーがコマンドの分類と権限をカスタマイズすることを許可します。

✨ 主な機能

📦 ディレクトリセキュリティシステム

ディレクトリセキュリティモード

システムは以下の3種類のディレクトリセキュリティモードをサポートしています。

ホワイトリストディレクトリの設定

"security": {
  "whitelisted_directories": [
    "/home",                  // システムディレクトリ
    "/tmp",
    "~",                      // ユーザーのホームディレクトリ
    "~/Documents"             // 一般的なユーザーディレクトリ
  ],
  "auto_approve_directories_in_desktop_mode": false  // 便利機能を有効にするにはtrueに設定
}

ディレクトリ承認フロー

1. 特定のディレクトリでコマンド実行のリクエストがある
2. システムがチェックする：
   • そのディレクトリがグローバルホワイトリストにあるか？ → 許可
   • そのディレクトリが現在のセッションの承認済みリストにあるか？ → 許可
   • どちらにも該当しない？ → 承認を要求
3. 承認が通った後、そのディレクトリはセッション全体で承認状態が維持される

サポートされるパス形式

• 絶対パス： /home/user/documents
• ホームディレクトリ： ~（ユーザーのホームディレクトリに展開される）
• ユーザーのサブディレクトリ： ~/Downloads

🔧 コマンドカスタマイズシステム

本システムはコマンドの分類を使用してアクセス権限を制御しています。

カスタマイズ方法

// config.json内
{
  "commands": {
    "read": ["ls", "cat", "grep", "awk", "jq"],
    "write": ["mkdir", "touch", "rm"],
    "system": ["ping", "ifconfig", "kubectl"],
    "blocked": ["sudo", "bash", "eval"]
  }
}

環境変数を使用する方法

# 既存のリストに追加（カンマ区切り）
export CMD_LINE_TOOL_COMMANDS_READ="ls,cat,grep"
export CMD_LINE_TOOL_COMMANDS_WRITE="mkdir,touch,rm"
export CMD_LINE_TOOL_COMMANDS_SYSTEM="ping/ifconfig/kubectl"
export CMD_LINE_TOOL_COMMANDS_BLOCKED="sudo/bash/eval"

🔑 セッション管理

システムはトークンベースのアクセス制御をサポートしており、ユーザーはトークン認証を通じてコマンドを実行できます。各セッションには独立したトークンがあり、タイムアウト後は自動的に無効になります。

# 新しいトークンを取得
$ tool --generate-token

# トークンを使用してコマンドを実行
$ tool --token <your_token> --command "ls -a"

📝 セキュリティ監査

システムは詳細なログ記録と監査機能を提供しており、実行されたすべてのコマンドとその結果が記録され、後のセキュリティレビューに役立ちます。

ログ形式の例

{
  "timestamp": "2024-01-20T15:30:45.123Z",
  "user": "admin",
  "command": "ls -a",
  "directory": "/home/admin",
  "status": "success",
  "output": [
    "file1.txt",
    "file2.png",
    ".hidden"
  ]
}

⚙️ 設定例

基本設定

# サービス起動時に監査機能を有効にする
$ tool --audit enable

# ホワイトリストディレクトリを設定
$ tool --config directory.add "/home/user/documents"

# 読み取りカテゴリにカスタムコマンドを追加
$ tool --config command.read "awk, jq"

❌ エラー処理

システムは詳細なエラー報告機構を提供しており、実行に失敗したすべてのコマンドの詳細なエラー情報が記録されます。

エラー出力の例

$ tool --token invalid_token --command "ls -a"

Command execution failed: Invalid token or session timeout
For more details, check the audit logs.

📚 付録

環境変数の参照

• CMD_LINE_TOOL_API_KEY：認証用のAPIキー
• CMD_LINE_TOOL_LOG_LEVEL：ログ記録レベルを設定（debug/info/warning/error/critical）
• CMD_LINE_TOOL_SESSION_TIMEOUT：セッションタイムアウト時間を設定（単位：秒）

エラーコードの参照

• 101: Invalid token or session timeout
• 102: Directory access denied
• 103: Command execution failed
• 104: Configuration error
• 105: Unauthorized command