Unofficial Elasticsearch MCP Server
About
A production-ready Model Context Protocol (MCP) server that connects AI assistants like Claude Desktop to Elasticsearch clusters. This server provides comprehensive Elasticsearch operations through natural language interactions.
Details
- Author
- zx8086
- Downloads
- 212
- Categories
- Database
Jump to
- 60+ Elasticsearch operations including search, indexing, and cluster management
- Type-safe configuration system with environment variable validation
- Read-only mode with strict/warning options for safe monitoring
- Advanced search with automatic highlighting, aggregations, and SQL support
- Efficient bulk indexing, updating, and deletion with helper APIs
- Cluster health checks, node statistics, and performance metrics
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Unofficial Elasticsearch MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via npx @elastic/mcp-server-elasticsearch or clone and build locally. Configure required environment variables ES_URL and an authentication method (ES_API_KEY or ES_USERNAME/ES_PASSWORD). Add to your MCP client configuration (e.g., Claude Desktop) with the appropriate command and env settings, then start asking natural language questions about your Elasticsearch data.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"unofficial elasticsearch mcp server": {
"mcp-server-elasticsearch-zx8086": {
"command": "npx",
"args": [
"@elastic/mcp-server-elasticsearch"
]
}
}
}
}
McpServers
{
"mcp-server-elasticsearch-zx8086": {
"command": "npx",
"args": [
"@elastic/mcp-server-elasticsearch"
]
}
}
Unofficial Elasticsearch MCP Server
A production-ready Model Context Protocol (MCP) server that connects AI assistants like Claude Desktop to Elasticsearch clusters. This server provides comprehensive Elasticsearch operations through natural language interactions, featuring advanced configuration management, security controls, and extensive tooling.
This is an enhancement of the Official Elastic MCP Server with the four tools (Core Operations).
🚀 Key Features
- 🔧 Comprehensive Tooling: 60+ Elasticsearch operations including search, indexing, cluster management, and analytics
- ⚙️ Advanced Configuration: Type-safe configuration system with environment variable validation
- 🔒 Security Controls: Read-only mode with strict/warning options for safe production monitoring
- 📊 Rich Search: Advanced search with automatic highlighting, aggregations, and SQL support
- 🔄 Bulk Operations: Efficient bulk indexing, updating, and deletion with helper APIs
- 📈 Cluster Monitoring: Health checks, node statistics, and performance metrics
- 🛡️ Error Handling: Robust error handling with detailed logging and troubleshooting guides
- ⚡ Performance: Built on Bun runtime for optimal performance and modern JavaScript features
📋 Table of Contents
- Prerequisites
- Installation
- Quick Start
- Configuration
- Available Tools
- Usage Examples
- Development
- Architecture
- Security
- Troubleshooting
🔧 Prerequisites
Installing Bun
This project uses Bun as the JavaScript runtime for optimal performance. Install Bun using one of these methods:
macOS/Linux:
curl -fsSL https://bun.sh/install | bash
Windows (PowerShell):
irm bun.sh/install.ps1 | iex
Package Managers:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



