개요

Elasticsearch와 OpenSearch 상호작용을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버 구현체입니다. 이 서버는 문서 검색, 인덱스 분석, 클러스터 관리를 도구 세트를 통해 가능하게 합니다.

데모

https://github.com/user-attachments/assets/f7409e31-fac4-4321-9c94-b0ff2ea7ff15

특징

일반 작전

• general_api_request: 일반적인 HTTP API 요청을 수행합니다. 전용 도구가 없는 Elasticsearch/OpenSearch API에 이 도구를 사용하세요.

인덱스 운영

• list_indices: 모든 인덱스를 나열합니다.
• get_index: 하나 이상의 인덱스에 대한 정보(매핑, 설정, 별칭)를 반환합니다.
• create_index: 새로운 인덱스를 생성합니다.
• delete_index: 인덱스를 삭제합니다.
• create_data_stream: 새로운 데이터 스트림 생성 (매칭 인덱스 템플릿 필요).
• get_data_stream: 하나 이상의 데이터 스트림에 대한 정보를 얻습니다.
• delete_data_stream: 하나 이상의 데이터 스트림과 그 뒷받침 인덱스를 삭제합니다.

문서 운영

• search_documents: 문서 검색.
• index_document: 인덱스 내 문서를 생성하거나 업데이트합니다.
• get_document: 신분증으로 문서를 받아.
• delete_document: ID로 문서를 삭제합니다.

Elasticsearch/OpenSearch MCP Server

Overview

A Model Context Protocol (MCP) server implementation that provides Elasticsearch and OpenSearch interaction. This server enables searching documents, analyzing indices, and managing cluster through a set of tools.

Demo

https://github.com/user-attachments/assets/f7409e31-fac4-4321-9c94-b0ff2ea7ff15

Features

General Operations

• general_api_request: Perform a general HTTP API request. Use this tool for any Elasticsearch/OpenSearch API that does not have a dedicated tool.

Index Operations

• list_indices: List all indices.
• get_index: Returns information (mappings, settings, aliases) about one or more indices.
• create_index: Create a new index.
• delete_index: Delete an index.
• create_data_stream: Create a new data stream (requires matching index template).
• get_data_stream: Get information about one or more data streams.
• delete_data_stream: Delete one or more data streams and their backing indices.

Document Operations

• search_documents: Search for documents.
• index_document: Creates or updates a document in the index.
• get_document: Get a document by ID.
• delete_document: Delete a document by ID.
• delete_by_query: Deletes documents matching the provided query.

Cluster Operations

• get_cluster_health: Returns basic information about the health of the cluster.
• get_cluster_stats: Returns high-level overview of cluster statistics.

Alias Operations

• list_aliases: List all aliases.
• get_alias: Get alias information for a specific index.
• put_alias: Create or update an alias for a specific index.
• delete_alias: Delete an alias for a specific index.

Analyzer Operations

• analyze_text: Analyze text using a specified analyzer or custom analysis chain. Useful for debugging search queries and understanding how text is tokenized.

Configure Environment Variables

The MCP server supports the following environment variables:

Basic Authentication (Username/Password)

• ELASTICSEARCH_USERNAME: Username for basic authentication
• ELASTICSEARCH_PASSWORD: Password for basic authentication
• OPENSEARCH_USERNAME: Username for OpenSearch basic authentication
• OPENSEARCH_PASSWORD: Password for OpenSearch basic authentication

API Key Authentication (Elasticsearch only) - Recommended