Shieldops

🚀 ShieldOps

Archestra MCPプラットフォーム上に構築された自律型のマルチエージェントセキュリティオペレーションセンター（SOC）です。ShieldOpsは、実際のMCPツール呼び出しとPostgreSQLの証拠チェーンを通じて、アラートのトリアージ、指標の調査、封じ込めプレイブックの実行、およびコンプライアンス対応のレポートを生成します。

✨ 主な機能

• 実際のMCP実行：シミュレーションにより、MCPサーバーに対する実際のツール呼び出しがトリガーされます（スクリプト化されたUIではありません）。
• 5つの専用エージェント：各フェーズ（トリアージ → 調査 → 対応 → レポート → 監視）ごとに最小限の特権でツールにアクセスします。
• 改ざん検知可能な証拠チェーン：各インシデントごとにタイムラインと証拠のハッシュが表示されます。
• 本番環境相当のスタック：PostgreSQL、Prometheus、Grafana、およびTerraformによるIaCが使用されています。
• 無料のデモパス：モックデータで動作するか、Dockerスタックで実際に動作させることができます。

🚀 クイックスタート

git clone https://github.com/SaaiAravindhRaja/shieldops.git
cd shieldops
cp .env.example .env

# インフラストラクチャを起動
Docker compose up -d

# ダッシュボードを起動（スタンドアロンまたは実稼働）
cd dashboard
npm install
npm run dev

ダッシュボード: http://localhost:3001
Archestra UI: http://localhost:3000

💻 使用例

基本的な使用法

# デモ: 実際のシミュレーション
# /simulateを開き、任意のシナリオを実行します。
# 各ステップで実際のMCPツール呼び出しが実行され、JSON-RPCプロトコルメッセージが表示されます。

パイプラインの概要:

1. Sentinelがアラートのトリアージを行います → incident-db/create_incident
2. Sherlockが調査を行います → threat-intel/*のルックアップ
3. Overseerが高リスクのアクションを承認します
4. Responderが封じ込めを行います → security-playbook/*
5. Chroniclerがレポートを生成します → コンプライアンスチェックを伴ってインシデントがクローズされます

📚 ドキュメント

アーキテクチャ

shieldops/
├── dashboard/               # Next.js 16 + Tailwind v4 + Recharts
│   ├── app/                 # UI + APIルート
│   ├── components/          # サイドバー、コマンドバー
│   └── lib/                 # MCPエンジン、データフック、ユーティリティ
├── mcp-servers/
│   ├── incident-db/         # インシデントのライフサイクル + 証拠チェーン
│   ├── threat-intel/        # AbuseIPDB / VirusTotal / NVD
│   └── security-playbook/   # 封じ込めアクション + プレイブック
├── terraform/               # Archestra IaC
├── grafana/                 # プロビジョニングされたダッシュボード
├── scripts/                 # DB初期化 + シードデータ
└── docker-compose.yml

エージェント

MCPサーバー（18個のツール）

Webhook取り込み

ShieldOpsは以下の方法でアラートを受け付けます。

curl -X POST http://localhost:3001/api/webhook/alert \
  -H "Content-Type: application/json" \
  -d '{"title":"Suspicious login from new country","severity":"P2","type":"unauthorized_access","source":"auth-service"}'

Prometheus AlertManager形式もサポートされています。

🔧 技術詳細

• DBが利用できない場合、モックデータで完全に動作します。
• 実際の脅威インテリジェンスのルックアップを行うには、.envにAPIキーを設定してください。
• デモ、ハッカソン、および概念実証デプロイメントを目的としています。

📄 ライセンス

MIT