elastic/mcp-server-elasticsearch

Developer tools 공식

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

728 stars 160 forks 품질 91 트렌드 42Apache-2.0

Repository Install

이 MCP 서버는 폐기되었으며 앞으로는 중요한 보안 업데이트만 받을 예정입니다. Elastic Agent Builder MCP 엔드포인트로 대체되었으며, Elastic 9.2에서 제공됩니다.

개요

이 MCP 서버는 현재는 지원이 중단되었으며, 앞으로는 중요한 보안 업데이트만 받을 예정입니다. 이 서버는 Elastic Agent Builder MCP 엔드포인트로 대체되었으며, Elastic 9.2.0+ 및 Elasticsearch Serverless 프로젝트에서 이용 가능합니다. Elasticsearch MCP 서버는 모델 컨텍스트 프로토콜(MCP)을 사용하여 AI 에이전트를 Elasticsearch 데이터에 연결합니다. 이 서버는 Elasticsearch 인덱스와 자연어 상호작용을 가능하게 하여, 에이전트가 맞춤형 API 없이도 데이터를 쿼리, 분석, 검색할 수 있게 합니다. AWS 마켓플레이스에서 Elasticsearch MCP 서버 컨테이너 이미지를 배포하고 구성하는 방법은 다음 단계를 따라가세요. - Elasticsearch 클러스터(버전 8.x 또는 9.

개요(AI 번역)

[! 주의] 이 MCP 서버는 폐기되었으며 앞으로는 중요한 보안 업데이트만 받을 예정입니다. 이 시스템은 Elastic 9.2.0+ 및 Elasticsearch Serverless 프로젝트에서 제공되는 Elastic Agent Builder MCP 엔드포인트로 대체되었습니다.

AI 에이전트를 위한 Elasticsearch MCP 서버 사용

Elasticsearch MCP 서버는 모델 컨텍스트 프로토콜(MCP)을 사용하여 AI 에이전트를 Elasticsearch 데이터에 연결합니다. 이 기능은 Elasticsearch 인덱스와 자연어로 상호작용할 수 있게 해, 에이전트가 맞춤형 API 없이도 데이터를 쿼리, 분석, 검색할 수 있게 합니다.

AWS 마켓플레이스에서 Elasticsearch MCP 서버 컨테이너 이미지를 배포하고 구성하는 방법은 다음 단계를 따라가세요.

시작하기 전에

시작하기 전에 다음을 확인하세요:

AWS 환경에서 접근 가능한 Elasticsearch 클러스터(버전 8.x 또는 9.x)
Elasticsearch 인증 자격 증명:
API 키 또는
사용자 이름과 비밀번호 쌍
AWS 환경에서 설치된 및 실행 중인 Docker (예: EC2 인스턴스 또는 컨테이너 서비스)
설정된 MCP 클라이언트(예: Claude Desktop, 커서, VS 코드 또는 다른 MCP 호환 도구)

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Elasticsearch MCP Server

[!CAUTION] This MCP server is deprecated and will only receive critical security updates going forward. It has been superseded by the Elastic Agent Builder MCP endpoint, which is available in Elastic 9.2.0+ and Elasticsearch Serverless projects.

Use the Elasticsearch MCP Server for AI Agents

The Elasticsearch MCP Server connects your AI agents to Elasticsearch data using the Model Context Protocol (MCP). It enables natural language interactions with your Elasticsearch indices, allowing agents to query, analyze, and retrieve data without custom APIs.

Follow these steps to deploy and configure the Elasticsearch MCP Server container image from AWS Marketplace.

Before you begin

Before you start, ensure you have:

An Elasticsearch cluster (version 8.x or 9.x) accessible from your AWS environment
Elasticsearch authentication credentials:
- An API key, or
- A username and password pair
Docker installed and running in your AWS environment (for example, on an EC2 instance or in a container service)
An MCP client configured (such as Claude Desktop, Cursor, VS Code, or another MCP-compatible tool)
Network connectivity between your deployment environment and your Elasticsearch cluster

[!NOTE]

These instructions apply to Elasticsearch MCP Server 0.4.0 and later. For versions 0.3.1 and earlier, refer to the README for v0.3.1.

Deploy the Elasticsearch MCP Server

The Elasticsearch MCP Server is provided as a Docker container image available from AWS Marketplace. You can run it using either the stdio protocol (for direct client connections) or the streamable-HTTP protocol (for web-based integrations).

Choose a protocol

The server supports two protocols:

stdio: Direct communication between the MCP client and server. Use this when your client supports stdio and runs in the same environment.
streamable-HTTP: HTTP-based protocol recommended for web integrations, stateful sessions, and concurrent clients.

Note: Server-Sent Events (SSE) is deprecated. Use streamable-HTTP instead.

Configure the stdio protocol

Use the stdio protocol when your MCP client connects directly to the server process.

Set environment variables for stdio mode

Set the following environment variables:

ES_URL: The URL of your Elasticsearch cluster (for example, https://your-cluster.es.amazonaws.com:9200)
For authentication, use one of these options:
- API key: Set ES_API_KEY to your Elasticsearch API key

GitHub에서 전체 README 보기

설치

docker run -i --rm -e ES_URL -e ES_API_KEY docker.elastic.co/mcp/elasticsearch stdio

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "elasticsearch-mcp-server": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "ES_URL",
        "-e", "ES_API_KEY",
        "docker.elastic.co/mcp/elasticsearch",
        "stdio"
      ],
      "env": {
        "ES_URL": "<elasticsearch-cluster-url>",
        "ES_API_KEY": "<elasticsearch-API-key>"
      }
    }
  }
}