🚀 Chronicle 安全运维 MCP 服务器
这是一个用于与 Google 的 Chronicle 安全运维套件交互的模型上下文协议（MCP）服务器，能帮助用户更好地与该套件进行交互，提升安全运维的效率和效果。
MCP 信息
🚀 快速开始
在 Claude 桌面端安装
要在 Claude 桌面端使用此 MCP 服务器，可按以下步骤操作：
- 安装 Claude 桌面端。
- 打开 Claude 桌面端，从菜单中选择“设置”。
- 点击左侧栏中的“开发者”，然后点击“编辑配置”。
- 使用以下配置更新你的
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"
}
}
}
}
- 确保更新：
uv的路径（使用which uv找到它）。- 此存储库所在的目录路径。
- 你的 Chronicle 凭据（项目 ID、客户 ID 和区域）。
- 保存文件并重启 Claude 桌面端。
- 现在你应该会在 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
手动安装
- 安装包：
pip install -e .
- 设置环境变量：
export CHRONICLE_PROJECT_ID="你的 Google Cloud 项目 ID"
export CHRONICLE_CUSTOMER_ID="你的 Chronicle 客户 ID"
export CHRONICLE_REGION="us" # 或者你的区域
💻 使用示例
基础用法
运行 MCP 服务器
python main.py
高级用法
API 功能
MCP 服务器提供以下功能：
- 搜索安全事件：在 Chronicle 中搜索安全事件。
- 获取安全警报：检索 Chronicle 的安全警报。
- 查找实体：查找实体信息（IP、域名、哈希等）。
- 列出安全规则：列出 Chronicle 的安全检测规则。
- 获取 IoCs 匹配项：获取指标匹配项。
🔧 技术细节
要求
- Python 3.11+ 版本。
- 启用 Chronicle Security Operations 的 Google Cloud 帐户。
- 正确配置身份验证。
⚠️ 注意事项
所有代码示例和配置指令均保留英文变量名，仅注释和说明部分翻译成中文。