Elasticsearch 7.x MCP Server

@imlewc

Basic information

About Elasticsearch 7.x MCP Server

elasticsearch7 mcp server

Elasticsearch 7.x MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "elasticsearch7-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@imlewc/elasticsearch7-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

Elasticsearch 7.x MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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

Frequently asked questions

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.