Elasticsearch — MCP-сервер для Claude Code
Подключает Elasticsearch к ИИ-агенту для запросов к данным, проверки полей и анализа событий безопасности.
claude mcp add --env ES_URL=<ES_URL> --env ES_API_KEY=<ES_API_KEY> --env ES_USERNAME=<ES_USERNAME> --env ES_PASSWORD=<ES_PASSWORD> --env ES_CA_CERT=<ES_CA_CERT> --transport stdio elasticsearch -- npx -y @tocharianou/elasticsearch-mcpЧто делает Elasticsearch
MCP-сервер даёт агенту доступ к API Elasticsearch и позволяет работать с кластером через обычные запросы. Он автоматически определяет версию Elasticsearch от 5.x до 9.x, выбирает подходящий клиент и отключает инструменты, которых эта версия не поддерживает.
В сервере есть query harness: перед выполнением он сверяет поля с возможностями живого кластера, исправляет некоторые ошибки в именах и предлагает реальные поля при сбое. Есть обход проверки через skip_lint, если запрос использует runtime-поля. Для подключения нужны экземпляр Elasticsearch и учётные данные: ES_API_KEY либо ES_USERNAME и ES_PASSWORD. Без ES_URL сервер не подключится.
Какие задачи решает
- искать события в индексах Elasticsearch
- проверять поля перед выполнением запроса
- анализировать неудачные входы и цепочки атак
- получать подсказки по ошибкам Elasticsearch
Примеры запросов агенту
- Найди неудачные входы по пользователям в Elasticsearch и покажи поля, которые использовал запрос.
- Проверь запрос к индексу: сверяй имена полей с кластером и исправь лишний суффикс
.keyword. - Проанализируй события безопасности и свяжи их в цепочку атаки.
Как установить Elasticsearch
Командой платформы
claude mcp add --env ES_URL=<ES_URL> --env ES_API_KEY=<ES_API_KEY> --env ES_USERNAME=<ES_USERNAME> --env ES_PASSWORD=<ES_PASSWORD> --env ES_CA_CERT=<ES_CA_CERT> --transport stdio elasticsearch -- npx -y @tocharianou/elasticsearch-mcpВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Командой платформы
codex mcp add elasticsearch --env ES_URL=<ES_URL> --env ES_API_KEY=<ES_API_KEY> --env ES_USERNAME=<ES_USERNAME> --env ES_PASSWORD=<ES_PASSWORD> --env ES_CA_CERT=<ES_CA_CERT> -- npx -y @tocharianou/elasticsearch-mcpВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"elasticsearch": {
"command": "npx",
"args": [
"-y",
"@tocharianou/elasticsearch-mcp"
],
"env": {
"ES_URL": "<ES_URL>",
"ES_API_KEY": "<ES_API_KEY>",
"ES_USERNAME": "<ES_USERNAME>",
"ES_PASSWORD": "<ES_PASSWORD>",
"ES_CA_CERT": "<ES_CA_CERT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"elasticsearch": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tocharianou/elasticsearch-mcp"
],
"env": {
"ES_URL": "<ES_URL>",
"ES_API_KEY": "<ES_API_KEY>",
"ES_USERNAME": "<ES_USERNAME>",
"ES_PASSWORD": "<ES_PASSWORD>",
"ES_CA_CERT": "<ES_CA_CERT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e ES_URL=<ES_URL> -e ES_API_KEY=<ES_API_KEY> -e ES_USERNAME=<ES_USERNAME> -e ES_PASSWORD=<ES_PASSWORD> -e ES_CA_CERT=<ES_CA_CERT> elasticsearch npx -y @tocharianou/elasticsearch-mcpВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Elasticsearch
Как установить Elasticsearch в Claude Code?
Выполните `claude mcp add elasticsearch -e ES_URL=<ES_URL> -e ES_API_KEY=<ES_API_KEY> -e ES_PASSWORD=<ES_PASSWORD> -- npx -y @tocharianou/elasticsearch-mcp`.
Что делает Elasticsearch MCP-сервер?
Он подключает Claude Code к Elasticsearch, выбирает клиент под версию кластера и проверяет запросы по реальным возможностям его полей.
Какие версии Elasticsearch поддерживаются?
Сервер автоматически работает с Elasticsearch 5.x–9.x. Для старых версий набор доступных инструментов сокращается.
