OpenSearch MCP 서버

OpenSearch에 저장된 Wazuh 보안 로그를 쿼리하고 분석하기 위한 MCP(Model Context Protocol) 서버입니다.

특징

고급 필터링을 사용하여 보안 알림 검색
특정 알림에 대한 자세한 정보를 얻으세요
보안 이벤트에 대한 통계 생성
시간 경과에 따른 알림 추세 시각화
장기 실행 작업에 대한 진행 상황 보고
구조화된 오류 처리

필수 조건

Node.js v16 이상
Wazuh 보안 로그가 포함된 OpenSearch 인스턴스에 액세스

설치

옵션 1: GitHub에서 직접 npx와 함께 사용(권장)

저장소를 복제하지 않고도 npx를 사용하여 이 도구를 직접 실행할 수 있습니다.

지엑스피1

옵션 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);

특허

MIT

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