Overview
What is Elasticsearch 7.x MCP Server?
Elasticsearch 7.x MCP Server is an MCP (Model Context Protocol) server that provides a protocol interface for interacting with Elasticsearch 7.x clusters. It is designed for developers who need to query and manage Elasticsearch 7.x (7.17.x recommended) directly from any MCP-compatible client.
How to use Elasticsearch 7.x MCP Server?
Install via Smithery (npx -y @smithery/cli install @imlewc/elasticsearch7-mcp-server --client claude) or manually (pip install -e .). Configure environment variables ELASTIC_HOST, ELASTIC_USERNAME, ELASTIC_PASSWORD, and optionally MCP_PORT (default 9999). Run the server with elasticsearch7-mcp-server or use the provided Docker Compose setup. Connect an MCP client to localhost:9999 and call methods like es-ping, es-info, and es-search.
Key features of Elasticsearch 7.x MCP Server
- Provides MCP protocol interface for Elasticsearch 7.x
- Supports basic operations: ping, info, and connection checks
- Full search functionality with aggregations, highlighting, and sorting
- Accessible through any MCP client
- Docker Compose included for a three-node ES 7.17.10 cluster
Use cases of Elasticsearch 7.x MCP Server
- Check Elasticsearch connection status with
es-ping - Retrieve cluster information via
es-info - Perform basic document searches with query parameters
- Run aggregation queries (e.g., terms, avg) using
es-search - Execute advanced searches with boolean filters, sorting, and highlighting
FAQ from Elasticsearch 7.x MCP Server
Which Elasticsearch versions are supported?
Elasticsearch 7.x is required; version 7.17.x is recommended.
What dependencies does the server need?
Python 3.10 or higher and a running Elasticsearch 7.x cluster.
How do I configure the server?
Set the environment variables ELASTIC_HOST, ELASTIC_USERNAME, ELASTIC_PASSWORD, and optionally MCP_PORT (default 9999).
Can I run it with Docker?
Yes, a docker-compose.yml is provided to start a three-node Elasticsearch 7.17.10 cluster, Kibana, and the MCP server. Create a .env file with ELASTIC_PASSWORD and run docker-compose up -d.
What transport or authentication does it use?
The server listens on a TCP port (default 9999) for MCP client connections and authenticates to Elasticsearch using the provided username and password.
