OpenSearch MCP 服务器

用于查询和分析存储在 OpenSearch 中的 Wazuh 安全日志的模型上下文协议 (MCP) 服务器。

特征

• 使用高级过滤功能搜索安全警报
• 获取有关特定警报的详细信息
• 生成安全事件统计数据
• 可视化随时间变化的警报趋势
• 长期运行操作的进度报告
• 结构化错误处理

先决条件

• Node.js v16 或更高版本
• 访问包含 Wazuh 安全日志的 OpenSearch 实例

安装

选项 1：直接从 GitHub 使用 npx（推荐）

您可以使用 npx 直接运行此工具，而无需克隆存储库：

选项 2：本地安装

1. 克隆此存储库：

2. 安装依赖项：

3. 配置环境变量：

4. 使用您的 OpenSearch 连接详细信息编辑.env文件：

运行服务器

启动服务器：

这将以 stdio 模式启动服务器。

启用调试日志记录：

使用 MCP CLI 进行测试：

这将使用 FastMCP CLI 工具运行服务器进行交互式测试。

使用 MCP Inspector 进行测试：

这将启动服务器并将其连接到 MCP Inspector 进行可视化调试。

服务器工具

该服务器提供以下工具：

1. 搜索提醒

在 Wazuh 数据中搜索安全警报。

参数：

• query ：搜索查询文本
• timeRange ：时间范围（例如 1h、24h、7d）
• maxResults ：返回的最大结果数
• index ：要搜索的索引模式

2. 获取警报详细信息

通过 ID 获取有关特定警报的详细信息。

参数：

• id ：警报 ID
• index ：索引模式

3. 警报统计

获取有关安全警报的统计数据。

参数：

• timeRange ：时间范围（例如 1h、24h、7d）
• field ：要聚合的字段（例如，rule.level、agent.name）
• index ：索引模式

4. 可视化警报趋势

可视化随时间变化的警报趋势。

参数：

• timeRange ：时间范围（例如 1h、24h、7d）
• interval ：分组的时间间隔（例如 1h、1d）
• query ：查询过滤警报
• index ：索引模式

示例用法

使用 MCP CLI 工具：

与客户端一起使用

要将此 MCP 服务器与客户端实现一起使用：

执照

麻省理工学院