Kisyntra/Agent_Sudo

Agent_Sudo は何をしますか？

AIエージェント向けのローカル権限ゲートウェイ。承認、委任、監査ログ、MCP統合を備えています。

概要

Agent_Sudoは、AIエージェント（例：Claude Code、Cursor、Codex）に対して、機密性の高い操作の実行を制御するためのローカル権限管理レイヤーです。エージェントがファイルの読み書き、コマンドの実行、外部APIへのアクセスなどを行う際に、人間の承認を要求したり、特定の権限を一時的に委任したり、すべての操作を詳細な監査ログに記録したりすることができます。

主な機能

• 承認ゲートウェイ: エージェントのアクションに対して、人間の承認を要求します。
• 権限委任: 信頼できるエージェントに、特定の範囲の権限を一時的に委任できます。
• 監査ログ: すべてのエージェントアクションをタイムスタンプ、アクター、操作内容とともに記録します。
• MCP統合: Model Context Protocolを介して外部ツールやリソースと連携します。

クイックスタート

インストール

git clone https://github.com/Kisyntra/Agent_Sudo.git
cd Agent_Sudo
pip install -r requirements.txt

設定

設定ファイル config.yaml を編集して、承認ルール、委任ポリシー、監査設定を定義します。

# config.yaml の例
audit:
  enabled: true
  log_path: ./audit.log
delegation:
  max_duration: 3600  # 秒単位
approval:
  required_actions:
    - file_write
    - command_exec
    - api_call

使用方法

エージェントのアクションを sudo でラップして実行します。

python agent_sudo.py --action file_write --path /etc/config.json

これにより、設定された承認ルールに基づいて、ユーザーに確認が行われます。

MCP統合

Agent_SudoはMCPサーバーとしても機能し、他のMCP対応ツールから権限ゲートウェイを利用できます。

{
  "mcpServers": {
    "agent-sudo": {
      "command": "python",
      "args": ["agent_sudo_mcp.py"],
      "env": {}
    }
  }
}

監査ログの例

2025-04-01T12:00:00Z | agent:claude | action:file_write | path:/var/log/app.log | approved:true
2025-04-01T12:01:00Z | agent:cursor | action:command_exec | command:rm -rf /tmp | approved:false

ドキュメント

詳細なドキュメントは docs/ ディレクトリを参照してください。

ライセンス

MIT