OpenSearch MCP サーバー

OpenSearch に保存されている Wazuh セキュリティログを照会および分析するための Model Context Protocol (MCP) サーバー。

特徴

高度なフィルタリングでセキュリティアラートを検索する
特定のアラートに関する詳細情報を取得する
セキュリティイベントの統計を生成する
アラートの傾向を時間経過とともに視覚化する
長時間実行操作の進捗レポート
構造化されたエラー処理

前提条件

Node.js v16以上
Wazuh セキュリティログを含む OpenSearch インスタンスへのアクセス

インストール

オプション 1: GitHub から直接 npx を使用する (推奨)

リポジトリをクローンせずに、npx を使用してこのツールを直接実行できます。

# Run the latest version from GitHub
npx github:jetbalsa/mcp-opensearch-js

# Run with debug mode enabled
npx github:jetbalsa/mcp-opensearch-js --debug

# You can also specify a specific branch or commit
npx github:jetbalsa/mcp-opensearch-js#main

オプション2: ローカルインストール

このリポジトリをクローンします:

git clone https://github.com/jetbalsa/mcp-opensearch-js.git
cd mcp-opensearch-js

依存関係をインストールします:

npm install

環境変数を設定します。

cp .env.example .env

OpenSearch 接続の詳細を使用して.envファイルを編集します。

OPENSEARCH_URL=https://your-opensearch-endpoint:9200
OPENSEARCH_USERNAME=your-username
OPENSEARCH_PASSWORD=your-password
DEBUG=false

サーバーの実行

サーバーを起動します。

npm start

これにより、サーバーが stdio モードで起動します。

デバッグログを有効にする:

npm run stdio:debug

MCP CLI でテストします。

npm run dev

これにより、対話型テスト用の FastMCP CLI ツールを使用してサーバーが実行されます。

MCP Inspector でテストします。

npm run inspect

これにより、サーバーが起動し、視覚的なデバッグのために MCP Inspector に接続されます。

サーバーツール

サーバーは次のツールを提供します。

1. 検索アラート

Wazuh データ内のセキュリティ警告を検索します。

パラメータ:

query : 検索クエリテキスト
timeRange : 時間範囲（例：1時間、24時間、7日）
maxResults : 返される結果の最大数
index : 検索するインデックスパターン

2. アラートの詳細を取得する

ID 別に特定のアラートの詳細情報を取得します。

パラメータ:

id : アラートID
index : インデックスパターン

3. アラート統計

セキュリティ警告に関する統計を取得します。

パラメータ:

timeRange : 時間範囲（例：1時間、24時間、7日）
field : 集計するフィールド (例: rule.level、agent.name)
index : インデックスパターン

4. アラートの傾向を視覚化する

アラートの傾向を時間経過とともに視覚化します。

パラメータ:

timeRange : 時間範囲（例：1時間、24時間、7日）
interval : グループ化する時間間隔（例：1時間、1日）
query : アラートをフィルタリングするクエリ
index : インデックスパターン

使用例

MCP CLI ツールの使用:

> tools
Available tools:
- searchAlerts: Search for security alerts in Wazuh data
- getAlertDetails: Get detailed information about a specific alert by ID
- alertStatistics: Get statistics about security alerts
- visualizeAlertTrend: Visualize alert trends over time

> tools.searchAlerts(query: "rule.level:>10", timeRange: "12h", maxResults: 5)

クライアントとの使用

この MCP サーバーをクライアント実装で使用するには:

import { Client } from "@modelcontextprotocol/sdk";
import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";

const client = new Client(
  {
    name: "example-client",
    version: "1.0.0",
  },
  {
    capabilities: {},
  },
);

const transport = new SSEClientTransport(new URL(`http://localhost:3000/sse`));

await client.connect(transport);

// Use tools
const result = await client.executeTool("searchAlerts", {
  query: "rule.level:>10",
  timeRange: "24h",
  maxResults: 10
});

console.log(result);

ライセンス

マサチューセッツ工科大学

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

アラートの検索、詳細情報の取得、統計の生成、傾向の視覚化などの機能を備え、OpenSearch に保存されている Wazuh セキュリティログのクエリと分析を可能にするモデルコンテキストプロトコルサーバーです。

Related MCP Servers

Couchbase MCP Server for LLMs
Aniket310101
-
security
F
license
-
quality
A Model Context Protocol server that enables large language models to interact directly with Couchbase databases through natural language, supporting operations like querying buckets, performing CRUD operations, and executing N1QL queries.
Last updated -
17
7
TypeScript
OpenSearch MCP Server
seohyunjun
A
security
A
license
A
quality
A Model Context Protocol server implementation that enables natural language interactions with OpenSearch clusters, allowing users to search documents, analyze indices, and manage clusters through simple conversational commands.
Last updated -
6
10
Python
Apache 2.0
Enrichment MCP Server
MSAdministrator
A
security
F
license
A
quality
A Model Context Protocol server that enables users to perform third-party enrichment lookups for security observables (IP addresses, domains, URLs, emails) through services like VirusTotal, Shodan, and others.
Last updated -
1
Python
FS-MCP Server
boleyn
-
security
A
license
-
quality
A Model Context Protocol server that provides intelligent file reading and semantic search capabilities across multiple document formats with security-first access controls.
Last updated -
5
Python
MIT License

View all related MCP servers

OpenSearch MCP Server