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"  # 或者你的区域

要求

• Python 3.11+ 版本
• 启用 Chronicle Security Operations 的 Google Cloud 帐户
• 正确配置身份验证

使用方法

运行 MCP 服务器

python main.py

API 功能

MCP 服务器提供以下功能：

1. 搜索安全事件：在 Chronicle 中搜索安全事件
2. 获取安全警报：检索 Chronicle 的安全警报
3. 查找实体：查找实体信息（IP、域名、哈希等）
4. 列出安全规则：列出 Chronicle 的安全检测规则
5. 获取 IoCs 匹配项：获取指标匹配项

注意事项

所有代码示例和配置指令均保留英文变量名，仅注释和说明部分翻译成中文。