Elasticsearch MCP: поиск и индексы через агента в Claude Code и Cursor

cr7258/elasticsearch-mcp-server· Проверено 12.11.2026· 317на GitHub

Подключает агента к кластеру Elasticsearch: список индексов и маппингов, поиск на query DSL и ES|QL. Сторонние серверы добавляют запись документов, алиасы и управление индексами.

3 реализации:

Самый широкий набор из 20 инструментов: индексы, документы, алиасы, data streams и запрос к любому API; работает и с OpenSearch, запись отключается одной переменной.

Как подключить

Что сделать до подключения

uv с командой uvx

Кластер Elasticsearch 7.x, 8.x или 9.x и API-ключ или логин с паролем

ELASTICSEARCH_API_KEY

API-ключ Elasticsearch или Elastic Cloud; вместо него можно задать ELASTICSEARCH_USERNAME и ELASTICSEARCH_PASSWORD

ELASTICSEARCH_HOSTS

адрес кластера, несколько узлов через запятую; по умолчанию https://localhost:9200

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env ELASTICSEARCH_HOSTS=https://localhost:9200 --env 'ELASTICSEARCH_API_KEY=<ваш API-ключ Elasticsearch>' --transport stdio elasticsearch \
  -- uvx elasticsearch-mcp-server

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.elasticsearch]
command = "uvx"
args = ["elasticsearch-mcp-server"]

[mcp_servers.elasticsearch.env]
ELASTICSEARCH_HOSTS = "https://localhost:9200"
ELASTICSEARCH_API_KEY = "<ваш API-ключ Elasticsearch>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "elasticsearch": {
      "command": "uvx",
      "args": ["elasticsearch-mcp-server"],
      "env": {
        "ELASTICSEARCH_HOSTS": "https://localhost:9200",
        "ELASTICSEARCH_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "elasticsearch": {
      "type": "stdio",
      "command": "uvx",
      "args": ["elasticsearch-mcp-server"],
      "env": {
        "ELASTICSEARCH_HOSTS": "https://localhost:9200",
        "ELASTICSEARCH_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "elasticsearch": {
      "command": "uvx",
      "args": ["elasticsearch-mcp-server"],
      "env": {
        "ELASTICSEARCH_HOSTS": "https://localhost:9200",
        "ELASTICSEARCH_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "elasticsearch": {
      "command": "uvx",
      "args": ["elasticsearch-mcp-server"],
      "env": {
        "ELASTICSEARCH_HOSTS": "https://localhost:9200",
        "ELASTICSEARCH_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "elasticsearch": {
        "type": "local",
        "command": ["uvx", "elasticsearch-mcp-server"],
        "environment": {
          "ELASTICSEARCH_HOSTS": "https://localhost:9200",
          "ELASTICSEARCH_API_KEY": "<ваш API-ключ Elasticsearch>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "elasticsearch": {
      "command": "uvx",
      "args": ["elasticsearch-mcp-server"],
      "env": {
        "ELASTICSEARCH_HOSTS": "https://localhost:9200",
        "ELASTICSEARCH_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "elasticsearch": {
      "command": "uvx",
      "args": ["elasticsearch-mcp-server"],
      "env": {
        "ELASTICSEARCH_HOSTS": "https://localhost:9200",
        "ELASTICSEARCH_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

list_indicesпоказывает все индексы

get_indexчитает маппинг, настройки и алиасы

create_indexсоздаёт индекс

delete_indexудаляет индекс

search_documentsищет документы

get_documentчитает документ по ID

index_documentсоздаёт или обновляет документ

delete_documentудаляет документ по ID

delete_by_queryудаляет документы по запросу

get_cluster_healthпоказывает здоровье кластера

get_cluster_statsсобирает статистику кластера

list_aliasesпоказывает все алиасы

get_aliasчитает алиасы индекса

put_aliasсоздаёт или меняет алиас

delete_aliasудаляет алиас

create_data_streamсоздаёт data stream

get_data_streamчитает data stream

delete_data_streamудаляет data stream

analyze_textразбирает текст анализатором

general_api_requestшлёт запрос к любому API

Пакет из npm на 11 инструментов: кроме поиска умеет reindex, загрузку пачкой и шаблоны индексов; рассчитан на Elasticsearch 8.x.

Как подключить

Что сделать до подключения

Node.js с командой npx

Кластер Elasticsearch 8.x и API-ключ или логин с паролем

ES_API_KEY

API-ключ Elasticsearch; вместо него можно задать ES_USERNAME и ES_PASSWORD

ES_HOST

адрес кластера, несколько узлов через запятую

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'ES_HOST=<адрес кластера>' --env 'ES_API_KEY=<ваш API-ключ Elasticsearch>' --transport stdio elasticsearch-mcp \
  -- npx -y @awesome-ai/elasticsearch-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.elasticsearch-mcp]
command = "npx"
args = ["-y", "@awesome-ai/elasticsearch-mcp"]

[mcp_servers.elasticsearch-mcp.env]
ES_HOST = "<адрес кластера>"
ES_API_KEY = "<ваш API-ключ Elasticsearch>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "elasticsearch-mcp": {
      "command": "npx",
      "args": ["-y", "@awesome-ai/elasticsearch-mcp"],
      "env": {
        "ES_HOST": "<адрес кластера>",
        "ES_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "elasticsearch-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@awesome-ai/elasticsearch-mcp"],
      "env": {
        "ES_HOST": "<адрес кластера>",
        "ES_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "elasticsearch-mcp": {
      "command": "npx",
      "args": ["-y", "@awesome-ai/elasticsearch-mcp"],
      "env": {
        "ES_HOST": "<адрес кластера>",
        "ES_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "elasticsearch-mcp": {
      "command": "npx",
      "args": ["-y", "@awesome-ai/elasticsearch-mcp"],
      "env": {
        "ES_HOST": "<адрес кластера>",
        "ES_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "elasticsearch-mcp": {
        "type": "local",
        "command": ["npx", "-y", "@awesome-ai/elasticsearch-mcp"],
        "environment": {
          "ES_HOST": "<адрес кластера>",
          "ES_API_KEY": "<ваш API-ключ Elasticsearch>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "elasticsearch-mcp": {
      "command": "npx",
      "args": ["-y", "@awesome-ai/elasticsearch-mcp"],
      "env": {
        "ES_HOST": "<адрес кластера>",
        "ES_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "elasticsearch-mcp": {
      "command": "npx",
      "args": ["-y", "@awesome-ai/elasticsearch-mcp"],
      "env": {
        "ES_HOST": "<адрес кластера>",
        "ES_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Инструменты сервера

elasticsearch_healthпоказывает здоровье кластера

list_indicesищет индексы, понимает regex

create_indexсоздаёт индекс с настройками

reindexпереносит данные между индексами

get_mappingsчитает маппинг индекса

create_mappingсоздаёт или меняет маппинг

searchищет запросом query DSL

bulkзагружает данные пачкой

create_index_templateсоздаёт шаблон индекса

get_index_templateчитает шаблоны индексов

delete_index_templateудаляет шаблон индекса

Сервер самой Elastic в Docker-образе, 5 инструментов для чтения и запросов, включая ES|QL; объявлен устаревшим и получает только критические исправления безопасности.

Как подключить

Что сделать до подключения

Docker

Кластер Elasticsearch 8.x или 9.x и API-ключ или логин с паролем

ES_API_KEY

API-ключ Elasticsearch; вместо него можно задать ES_USERNAME и ES_PASSWORD

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'ES_URL=<адрес кластера Elasticsearch>' --env 'ES_API_KEY=<ваш API-ключ Elasticsearch>' --transport stdio mcp-server-elasticsearch \
  -- docker run -i --rm -e ES_URL -e ES_API_KEY docker.elastic.co/mcp/elasticsearch stdio

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-server-elasticsearch]
command = "docker"
args = ["run", "-i", "--rm", "-e", "ES_URL", "-e", "ES_API_KEY", "docker.elastic.co/mcp/elasticsearch", "stdio"]

[mcp_servers.mcp-server-elasticsearch.env]
ES_URL = "<адрес кластера Elasticsearch>"
ES_API_KEY = "<ваш API-ключ Elasticsearch>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-server-elasticsearch": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ES_URL",
        "-e",
        "ES_API_KEY",
        "docker.elastic.co/mcp/elasticsearch",
        "stdio"
      ],
      "env": {
        "ES_URL": "<адрес кластера Elasticsearch>",
        "ES_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-server-elasticsearch": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ES_URL",
        "-e",
        "ES_API_KEY",
        "docker.elastic.co/mcp/elasticsearch",
        "stdio"
      ],
      "env": {
        "ES_URL": "<адрес кластера Elasticsearch>",
        "ES_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-server-elasticsearch": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ES_URL",
        "-e",
        "ES_API_KEY",
        "docker.elastic.co/mcp/elasticsearch",
        "stdio"
      ],
      "env": {
        "ES_URL": "<адрес кластера Elasticsearch>",
        "ES_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-server-elasticsearch": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ES_URL",
        "-e",
        "ES_API_KEY",
        "docker.elastic.co/mcp/elasticsearch",
        "stdio"
      ],
      "env": {
        "ES_URL": "<адрес кластера Elasticsearch>",
        "ES_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-server-elasticsearch": {
        "type": "local",
        "command": [
          "docker",
          "run",
          "-i",
          "--rm",
          "-e",
          "ES_URL",
          "-e",
          "ES_API_KEY",
          "docker.elastic.co/mcp/elasticsearch",
          "stdio"
        ],
        "environment": {
          "ES_URL": "<адрес кластера Elasticsearch>",
          "ES_API_KEY": "<ваш API-ключ Elasticsearch>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-server-elasticsearch": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ES_URL",
        "-e",
        "ES_API_KEY",
        "docker.elastic.co/mcp/elasticsearch",
        "stdio"
      ],
      "env": {
        "ES_URL": "<адрес кластера Elasticsearch>",
        "ES_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-server-elasticsearch": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ES_URL",
        "-e",
        "ES_API_KEY",
        "docker.elastic.co/mcp/elasticsearch",
        "stdio"
      ],
      "env": {
        "ES_URL": "<адрес кластера Elasticsearch>",
        "ES_API_KEY": "<ваш API-ключ Elasticsearch>"
      }
    }
  }
}

Инструменты сервера

list_indicesпоказывает все индексы

get_mappingsчитает маппинг индекса

searchищет запросом query DSL

esqlвыполняет запрос ES|QL

get_shardsпоказывает шарды индексов

Что попросить агента

«Какое состояние у моего кластера Elasticsearch?»Агент вызовет get_cluster_health у cr7258 или elasticsearch_health у awesimon

«Покажи маппинг полей индекса <индекс>»Агент вызовет get_mappings или get_index и перечислит поля с типами

«Найди заказы дороже <сумма> за прошлый месяц»Агент найдёт индекс через list_indices, посмотрит поля в get_mappings и соберёт запрос для search

«Создай индекс <имя> с 3 шардами и 1 репликой»Агент вызовет create_index с настройками шардов и реплик

«Перенеси данные из <старый индекс> в <новый индекс>»awesimon вызовет reindex с исходным и целевым индексом

Для каких задач

Найти документы в индексе запросом на query DSL или ES|QL

Показать индексы и маппинг полей перед тем, как писать запрос

Проверить здоровье кластера и распределение шардов

Создать индекс, маппинг или шаблон и загрузить данные пачкой

Разобрать, на какие токены анализатор режет текст, когда поиск не находит документ

Работать с кластером OpenSearch через тот же сервер cr7258

Ограничения

Сервер Elastic объявлен устаревшим: его заменил MCP-эндпоинт Elastic Agent Builder, доступный в Elastic 9.2.0 и новее и в Serverless-проектах

У cr7258 по умолчанию открыты запись и удаление, включая delete_by_query и general_api_request, а проверка SSL-сертификатов выключена (VERIFY_CERTS=false)

awesimon проверен только на Elasticsearch 8.x: 7.x и 9.x не тестировались, npm test проверяет лишь компиляцию TypeScript

В режиме HTTP сервер cr7258 без переменной MCP_API_KEY открыт любому, кто достучится до порта

Если не работает

Сервер подключён, но агент не получает данные из кластера

Проверьте, что адрес ES_URL доступен из контейнера, ключ действителен и имеет нужные права, а контейнер запустился: ошибки видны в docker logs <id контейнера>.

Claude Desktop не подключается к серверу Elastic в режиме HTTP

Бесплатный Claude Desktop понимает только stdio: поставьте mcp-proxy командой uv tool install mcp-proxy и укажите его в command с флагом --transport=streamablehttp и адресом http://<хост>:<порт>/mcp.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Elasticsearch/OpenSearch MCP Server	cr7258	317	локально	токен	20	11 ноября 2026
Elasticsearch MCP Server	awesimon	24	локально	токен	11	12 ноября 2026
Elasticsearch MCP Serverразработчик сервиса	Elastic	732	локально	токен	5	6 ноября 2026

Частые вопросы

Какой из трёх серверов выбрать?

cr7258 подойдёт для работы с индексами, документами и алиасами, а также для OpenSearch. awesimon ставится из npm и умеет reindex и загрузку пачкой. Сервер Elastic только читает данные и понимает ES|QL, но больше не развивается.

Как запретить агенту удалять данные?

В cr7258 задайте DISABLE_HIGH_RISK_OPERATIONS=true: инструменты записи и удаления скроются от клиента. Отдельные инструменты отключаются списком в DISABLE_OPERATIONS. Для любого сервера выдайте API-ключ с правами только на чтение нужных индексов.

Что пришло на смену серверу Elastic?

MCP-эндпоинт Elastic Agent Builder. Он есть в Elastic 9.2.0 и новее и в проектах Elasticsearch Serverless.

Как подключить несколько кластеров к одному серверу?

В cr7258 задайте ELASTICSEARCH_CLUSTERS с JSON-описанием кластеров или ELASTICSEARCH_CLUSTERS_FILE с путём к такому файлу. Кластер по умолчанию выбирает DEFAULT_CLUSTER, остальные агент указывает параметром cluster.

Какой пакет cr7258 брать под Elasticsearch 7 или 9?

Пакет elasticsearch-mcp-server рассчитан на 8.x. Для 7.x запускайте elasticsearch-mcp-server-es7, для 9.x — elasticsearch-mcp-server-es9, для OpenSearch — opensearch-mcp-server.

Как подключить Elasticsearch MCP к Claude Code?

Откройте вкладку Claude Code в блоке «Как подключить». Сервер cr7258 запускается командой uvx elasticsearch-mcp-server с переменными ELASTICSEARCH_HOSTS и ELASTICSEARCH_API_KEY.

Где Elasticsearch MCP на GitHub?

Сервер Elastic лежит в репозитории elastic/mcp-server-elasticsearch, образ — docker.elastic.co/mcp/elasticsearch. Сторонние: cr7258/elasticsearch-mcp-server на PyPI и awesimon/elasticsearch-mcp в npm как @awesome-ai/elasticsearch-mcp.

Есть ли Elasticsearch MCP для OpenSearch?

Да, у cr7258 есть пакет opensearch-mcp-server для OpenSearch 1.x, 2.x и 3.x. Он берёт переменные OPENSEARCH_HOSTS, OPENSEARCH_USERNAME и OPENSEARCH_PASSWORD.

Работает ли сервер из России?

Серверы запускаются на вашем компьютере или в Docker и обращаются только к вашему кластеру, данные остаются в нём.

Elasticsearch MCP: поиск и индексы через агента в Claude Code и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы