Сервер Elasticsearch MCP

Сервер Elasticsearch/OpenSearch MCP

Обзор

Реализация сервера Model Context Protocol (MCP), которая обеспечивает взаимодействие Elasticsearch и OpenSearch. Этот сервер позволяет искать документы, анализировать индексы и управлять кластером с помощью набора инструментов.

Демо

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

Функции

Общие операции

general_api_request : Выполнить общий запрос HTTP API. Используйте этот инструмент для любого API Elasticsearch/OpenSearch, у которого нет специального инструмента.

Индексные операции

list_indices : Список всех индексов.
get_index : Возвращает информацию (сопоставления, настройки, псевдонимы) об одном или нескольких индексах.
create_index : Создать новый индекс.
delete_index : Удалить индекс.

Операции с документами

search_documents : Поиск документов.
index_document : Создает или обновляет документ в индексе.
get_document : Получить документ по идентификатору.
delete_document : Удалить документ по идентификатору.
delete_by_query : Удаляет документы, соответствующие предоставленному запросу.

Кластерные операции

get_cluster_health : возвращает основную информацию о состоянии кластера.
get_cluster_stats : возвращает общий обзор статистики кластера.

Операции под псевдонимом

list_aliases : Список всех псевдонимов.
get_alias : Получить информацию о псевдониме для определенного индекса.
put_alias : создать или обновить псевдоним для определенного индекса.
delete_alias : Удалить псевдоним для определенного индекса.

Настроить переменные среды

Скопируйте файл .env.example в .env и обновите значения соответствующим образом.

Запустить кластер Elasticsearch/OpenSearch

Запустите кластер Elasticsearch/OpenSearch с помощью Docker Compose:

# For Elasticsearch
docker-compose -f docker-compose-elasticsearch.yml up -d

# For OpenSearch
docker-compose -f docker-compose-opensearch.yml up -d

Имя пользователя Elasticsearch по умолчанию — elastic , а пароль — test123 . Имя пользователя OpenSearch по умолчанию — admin , а пароль — admin .

Доступ к панелям управления Kibana/OpenSearch можно получить по адресу http://localhost:5601 .

Использование с Claude Desktop

Вариант 1: Установка через Smithery

Чтобы автоматически установить Elasticsearch Server для Claude Desktop через Smithery :

npx -y @smithery/cli install elasticsearch-mcp-server --client claude

Вариант 2: Использование uvx

Использование uvx автоматически установит пакет из PyPI, нет необходимости клонировать репозиторий локально. Добавьте следующую конфигурацию в файл конфигурации Claude Desktop claude_desktop_config.json .

// For Elasticsearch
{
  "mcpServers": {
    "elasticsearch-mcp-server": {
      "command": "uvx",
      "args": [
        "elasticsearch-mcp-server"
      ],
      "env": {
        "ELASTICSEARCH_HOSTS": "https://localhost:9200",
        "ELASTICSEARCH_USERNAME": "elastic",
        "ELASTICSEARCH_PASSWORD": "test123"
      }
    }
  }
}

// For OpenSearch
{
  "mcpServers": {
    "opensearch-mcp-server": {
      "command": "uvx",
      "args": [
        "opensearch-mcp-server"
      ],
      "env": {
        "OPENSEARCH_HOSTS": "https://localhost:9200",
        "OPENSEARCH_USERNAME": "admin",
        "OPENSEARCH_PASSWORD": "admin"
      }
    }
  }
}

Вариант 3: Использование УФ-излучения с локальной проявкой

Использование uv требует локального клонирования репозитория и указания пути к исходному коду. Добавьте следующую конфигурацию в файл конфигурации Claude Desktop claude_desktop_config.json .

// For Elasticsearch
{
  "mcpServers": {
    "elasticsearch-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/src/elasticsearch_mcp_server",
        "run",
        "elasticsearch-mcp-server"
      ],
      "env": {
        "ELASTICSEARCH_HOSTS": "https://localhost:9200",
        "ELASTICSEARCH_USERNAME": "elastic",
        "ELASTICSEARCH_PASSWORD": "test123"
      }
    }
  }
}

// For OpenSearch
{
  "mcpServers": {
    "opensearch-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/src/elasticsearch_mcp_server",
        "run",
        "opensearch-mcp-server"
      ],
      "env": {
        "OPENSEARCH_HOSTS": "https://localhost:9200",
        "OPENSEARCH_USERNAME": "admin",
        "OPENSEARCH_PASSWORD": "admin"
      }
    }
  }
}

В macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
В Windows: %APPDATA%/Claude/claude_desktop_config.json

Перезапустите Claude Desktop, чтобы загрузить новый сервер MCP.

Теперь вы можете взаимодействовать с кластером Elasticsearch/OpenSearch через Claude, используя команды естественного языка, например:

«Список всех индексов в кластере»
«Сколько лет студенту Бобу?»
«Покажите мне состояние работоспособности кластера»

Использование с клиентом Anthropic MCP

uv run mcp_client/client.py src/server.py

Лицензия

Данный проект лицензирован в соответствии с лицензией Apache License Version 2.0 — подробности см. в файле LICENSE .

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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.

Tools

Облегчает взаимодействие с кластерами Elasticsearch, позволяя пользователям выполнять операции индексации, поиск документов и управление кластерами через сервер Model Context Protocol и команды на естественном языке.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Elasticsearch MCP Server
da1y
-
security
F
license
-
quality
A Model Context Protocol server that enables LLMs to interact with Elasticsearch clusters, allowing them to manage indices and execute search queries using natural language.
Last updated -
1
JavaScript
Elasticsearch 7.x MCP Server
imlewc
A
security
A
license
A
quality
Provides an MCP protocol interface for interacting with Elasticsearch 7.x databases, supporting comprehensive search functionality including aggregations, highlighting, and sorting.
Last updated -
3
1
Python
Apache 2.0
Elasticsearch MCP Serverofficial
elastic
A
security
A
license
A
quality
Connects Claude and other MCP clients to Elasticsearch data, allowing users to interact with their Elasticsearch indices through natural language conversations.
Last updated -
3
800
298
TypeScript
Apache 2.0
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
8
Python
Apache 2.0

View all related MCP servers

Elasticsearch MCP Server