MCP Secops V3

🚀 Chronicle 安全運維 MCP 服務器

這是一個用於與 Google 的 Chronicle 安全運維套件交互的模型上下文協議（MCP）服務器，能幫助用戶更好地與該套件進行交互，提升安全運維的效率和效果。 MCP 信息

🚀 快速開始

在 Claude 桌面端安裝

要在 Claude 桌面端使用此 MCP 服務器，可按以下步驟操作：

1. 安裝 Claude 桌面端。
2. 打開 Claude 桌面端，從菜單中選擇“設置”。
3. 點擊左側欄中的“開發者”，然後點擊“編輯配置”。
4. 使用以下配置更新你的 claude_desktop_config.json 文件（將路徑替換為你的實際路徑）：

{
  "mcpServers": {
    "secops-mcp": {
      "command": "/path/to/your/uv",
      "args": [
        "--directory",
        "/path/to/your/mcp-secops-v3",
        "run",
        "secops_mcp.py"
      ],
      "env": {
        "CHRONICLE_PROJECT_ID": "你的 Google Cloud 項目 ID",
        "CHRONICLE_CUSTOMER_ID": "你的 Chronicle 客戶 ID",
        "CHRONICLE_REGION": "us"
      }
    }
  }
}

5. 確保更新：
   • uv 的路徑（使用 which uv 找到它）。
   • 此存儲庫所在的目錄路徑。
   • 你的 Chronicle 憑據（項目 ID、客戶 ID 和區域）。
6. 保存文件並重啟 Claude 桌面端。
7. 現在你應該會在 Claude 桌面界面看到錘子圖標，表示 MCP 服務器已激活。

✨ 主要特性

安全工具

• search_security_events：搜索 Chronicle 中的安全事件，支持自定義查詢。
• get_security_alerts：獲取 Chronicle 的安全警報。
• lookup_entity：查找實體信息（IP、域名、哈希等）。
• list_security_rules：列出 Chronicle 的安全檢測規則。
• get_ioc_matches：獲取指標（IoCs）匹配項。

📦 安裝指南

通過 Smithery 安裝

要自動通過 Smithery 安裝 mcp - secops - v3，可使用以下命令：

npx -y @smithery/cli install @emeryray2002/mcp-secops-v3 --client claude

手動安裝

1. 安裝包：

pip install -e .

2. 設置環境變量：

export CHRONICLE_PROJECT_ID="你的 Google Cloud 項目 ID"
export CHRONICLE_CUSTOMER_ID="你的 Chronicle 客戶 ID"
export CHRONICLE_REGION="us"  # 或者你的區域

💻 使用示例

基礎用法

運行 MCP 服務器

python main.py

高級用法

API 功能

MCP 服務器提供以下功能：

1. 搜索安全事件：在 Chronicle 中搜索安全事件。
2. 獲取安全警報：檢索 Chronicle 的安全警報。
3. 查找實體：查找實體信息（IP、域名、哈希等）。
4. 列出安全規則：列出 Chronicle 的安全檢測規則。
5. 獲取 IoCs 匹配項：獲取指標匹配項。

🔧 技術細節

要求

• Python 3.11+ 版本。
• 啟用 Chronicle Security Operations 的 Google Cloud 帳戶。
• 正確配置身份驗證。

⚠️ 注意事項

所有代碼示例和配置指令均保留英文變量名，僅註釋和說明部分翻譯成中文。