Shieldops

🚀 ShieldOps

ShieldOps是一個基於Archestra MCP平臺構建的自主多智能體安全運營中心（SOC）。它能夠對警報進行分類，調查指標，執行遏制策略，並通過真實的MCP工具調用和PostgreSQL證據鏈生成符合合規要求的報告。

🚀 快速開始

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用戶界面地址：http://localhost:3000

✨ 主要特性

• 真實的MCP執行：模擬觸發針對MCP服務器的即時工具調用（非腳本化的用戶界面）。
• 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

高級用法

即時模擬演示

打開 /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/                 # 用戶界面 + API路由
│   ├── components/          # 側邊欄、命令欄
│   └── lib/                 # MCP引擎、數據鉤子、實用工具
├── mcp-servers/
│   ├── incident-db/         # 事件生命週期 + 證據鏈
│   ├── threat-intel/        # AbuseIPDB / VirusTotal / NVD
│   └── security-playbook/   # 遏制操作 + 策略
├── terraform/               # Archestra基礎設施即代碼
├── grafana/                 # 預配置的儀表盤
├── scripts/                 # 數據庫初始化 + 種子數據
└── docker-compose.yml

智能體

MCP服務器（18個工具）

網絡鉤子攝入

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格式。

🔧 技術細節

ShieldOps基於Archestra MCP平臺構建，利用PostgreSQL作為事件數據庫，通過真實的MCP工具調用實現警報分類、調查、遏制和報告等功能。智能體採用不同的Gemini模型，根據不同階段的需求調用相應的MCP工具。系統使用Terraform實現基礎設施即代碼，結合Prometheus和Grafana進行指標監控和可觀測性管理。

📄 許可證

本項目採用MIT許可證。

⚠️ 重要提示

• 如果數據庫不可用，可完全使用模擬數據運行。
• 若要進行即時威脅情報查找，請在 .env 中提供API密鑰。
• 本項目旨在用於演示、黑客馬拉松和概念驗證部署。