elastic/mcp-server-elasticsearch

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

728 stars 160 forks Качество 91 Тренд 42Apache-2.0

Этот MCP-сервер устарел и будет получать только критические обновления безопасности. Его заменил конечный пункт Elastic Agent Builder MCP, доступный в версии Elastic 9.2.

Обзор

Этот MCP-сервер устарел и будет получать только критически важные обновления безопасности. Его заменил Elastic Agent Builder MCP endpoint, доступный в проектах Elastic 9.2.0+ и Elasticsearch Serverless. Elasticsearch MCP Server соединяет ваших AI-агентов с данными Elasticsearch с помощью протокола Model Context Protocol (MCP). Он позволяет использовать естественное взаимодействие с вашими индексами Elasticsearch, позволяя агентам делать запросы, анализировать и получать данные без пользовательских API. Следуйте этим шагам для развертывания и настройки образа контейнера Elasticsearch MCP Server из AWS Marketplace. - Кластер Elasticsearch (версии 8.x или 9.

Обзор (машинный перевод)

[! ВНИМАНИЕ] Этот MCP-сервер устарел и будет получать только критически важные обновления безопасности. Её заменил конечный модуль Elastic Agent Builder MCP, который доступен в проектах Elastic 9.2.0+ и Elasticsearch Serverless.

Используйте сервер Elasticsearch MCP для AI-агентов

Elasticsearch MCP Server соединяет ваши AI-агенты с данными Elasticsearch с помощью протокола Model Context Protocol (MCP). Он позволяет использовать естественный язык с индексами Elasticsearch, позволяя агентам делать запросы, анализировать и получать данные без пользовательских API.

Следуйте этим шагам для развертывания и настройки образа контейнера Elasticsearch MCP Server из AWS Marketplace.

Прежде чем начнёшь

Перед началом убедитесь, что у вас есть:

Кластер Elasticsearch (версии 8.x или 9.x), доступный из вашей среды AWS
Учётные данные аутентификации Elasticsearch:
Ключ API, или
Пара имени пользователя и пароля
Docker, установленный и запущенный в вашей среде AWS (например, на экземпляре EC2 или в контейнерном сервисе)
Настроенный MCP-клиент (например, Claude Desktop, Cursor, VS Code или другой инструмент, совместимый с MCP)

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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

Открыть полный README на GitHub

Установка

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>"
      }
    }
  }
}