elasticsearch-mcp-server — MCP-сервер для Claude Code: функции
Даёт агенту инструменты для работы с Elasticsearch и OpenSearch: поиск документов, просмотр индексов и управление кластером. Подходит для задач с данными из поискового хранилища.
claude mcp add --env ELASTICSEARCH_HOSTS=<ELASTICSEARCH_HOSTS> --env ELASTICSEARCH_API_KEY=<ELASTICSEARCH_API_KEY> --env ELASTICSEARCH_USERNAME=<ELASTICSEARCH_USERNAME> --env ELASTICSEARCH_PASSWORD=<ELASTICSEARCH_PASSWORD> --env ELASTICSEARCH_VERIFY_CERTS=<ELASTICSEARCH_VERIFY_CERTS> --transport stdio elasticsearch-mcp-server -- uvx elasticsearch-mcp-serverЧто делает elasticsearch-mcp-server
Сервер предоставляет инструменты для поиска, чтения, добавления и удаления документов. Агент также может просматривать индексы и алиасы, создавать индексы и потоки данных, проверять состояние кластера и анализировать токенизацию текста. Для запросов к API без отдельного инструмента есть общий HTTP-запрос.
Подключение настраивается через переменные окружения: можно задать адреса хостов, имя пользователя и пароль либо API-ключ Elasticsearch. Сервер поддерживает несколько именованных кластеров; конфигурацию можно передать JSON-строкой или указать путь к JSON-файлу. Вызов инструмента может выбрать кластер параметром cluster.
Для HTTP-транспорта без MCP_API_KEY сервер доступен без аутентификации, поэтому при сетевом доступе ключ нужно настроить. В Claude Code сервер запускается через uvx; для подключения задайте параметры доступа к вашему кластеру.
Какие задачи решает
- найти документы по запросу в Elasticsearch
- проверить маппинги и настройки индекса
- добавить или удалить документ по ID
- посмотреть состояние кластера и его статистику
- проверить, как анализатор разбивает текст на токены
Примеры запросов агенту
- Найди в индексе
logs-*документы с ошибками за указанный период. - Покажи маппинги и настройки индекса
products. - Проанализируй текст указанным анализатором и покажи токены.
Как установить elasticsearch-mcp-server
Командой платформы
claude mcp add --env ELASTICSEARCH_HOSTS=<ELASTICSEARCH_HOSTS> --env ELASTICSEARCH_API_KEY=<ELASTICSEARCH_API_KEY> --env ELASTICSEARCH_USERNAME=<ELASTICSEARCH_USERNAME> --env ELASTICSEARCH_PASSWORD=<ELASTICSEARCH_PASSWORD> --env ELASTICSEARCH_VERIFY_CERTS=<ELASTICSEARCH_VERIFY_CERTS> --transport stdio elasticsearch-mcp-server -- uvx elasticsearch-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from elasticsearch-mcp-server <команда>
Командой платформы
codex mcp add elasticsearch-mcp-server --env ELASTICSEARCH_HOSTS=<ELASTICSEARCH_HOSTS> --env ELASTICSEARCH_API_KEY=<ELASTICSEARCH_API_KEY> --env ELASTICSEARCH_USERNAME=<ELASTICSEARCH_USERNAME> --env ELASTICSEARCH_PASSWORD=<ELASTICSEARCH_PASSWORD> --env ELASTICSEARCH_VERIFY_CERTS=<ELASTICSEARCH_VERIFY_CERTS> -- uvx elasticsearch-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from elasticsearch-mcp-server <команда>
Файл настроек
{
"mcpServers": {
"elasticsearch-mcp-server": {
"command": "uvx",
"args": [
"elasticsearch-mcp-server"
],
"env": {
"ELASTICSEARCH_HOSTS": "<ELASTICSEARCH_HOSTS>",
"ELASTICSEARCH_API_KEY": "<ELASTICSEARCH_API_KEY>",
"ELASTICSEARCH_USERNAME": "<ELASTICSEARCH_USERNAME>",
"ELASTICSEARCH_PASSWORD": "<ELASTICSEARCH_PASSWORD>",
"ELASTICSEARCH_VERIFY_CERTS": "<ELASTICSEARCH_VERIFY_CERTS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from elasticsearch-mcp-server <команда>
Файл настроек
{
"servers": {
"elasticsearch-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"elasticsearch-mcp-server"
],
"env": {
"ELASTICSEARCH_HOSTS": "<ELASTICSEARCH_HOSTS>",
"ELASTICSEARCH_API_KEY": "<ELASTICSEARCH_API_KEY>",
"ELASTICSEARCH_USERNAME": "<ELASTICSEARCH_USERNAME>",
"ELASTICSEARCH_PASSWORD": "<ELASTICSEARCH_PASSWORD>",
"ELASTICSEARCH_VERIFY_CERTS": "<ELASTICSEARCH_VERIFY_CERTS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from elasticsearch-mcp-server <команда>
Командой платформы
gemini mcp add -e ELASTICSEARCH_HOSTS=<ELASTICSEARCH_HOSTS> -e ELASTICSEARCH_API_KEY=<ELASTICSEARCH_API_KEY> -e ELASTICSEARCH_USERNAME=<ELASTICSEARCH_USERNAME> -e ELASTICSEARCH_PASSWORD=<ELASTICSEARCH_PASSWORD> -e ELASTICSEARCH_VERIFY_CERTS=<ELASTICSEARCH_VERIFY_CERTS> elasticsearch-mcp-server uvx elasticsearch-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from elasticsearch-mcp-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о elasticsearch-mcp-server
Как установить elasticsearch-mcp-server в Claude Code?
Выполните команду `claude mcp add elasticsearch-mcp-server -e ELASTICSEARCH_API_KEY=<ELASTICSEARCH_API_KEY> -e ELASTICSEARCH_PASSWORD=<ELASTICSEARCH_PASSWORD> -- uvx elasticsearch-mcp-server`. Перед запуском задайте учётные данные для Elasticsearch.
Что делает elasticsearch-mcp-server?
Он подключает инструменты Elasticsearch и OpenSearch к агенту. Через них можно искать документы, управлять индексами и алиасами, а также получать сведения о кластере.
Можно ли подключить несколько кластеров?
Да. Задайте ELASTICSEARCH_CLUSTERS или OPENSEARCH_CLUSTERS либо укажите файл через ELASTICSEARCH_CLUSTERS_FILE или OPENSEARCH_CLUSTERS_FILE. Для конкретного кластера передавайте параметр cluster.
