This project provides an experimental Elasticsearch MCP server that allows Model Context Protocol (MCP) clients to interact with Elasticsearch indices via natural language. It targets users who want to query their Elasticsearch data using conversational AI, offering tools for listing indices, retrieving mappings, performing searches, and executing ES|QL queries.

How It Works

The server acts as a bridge, translating natural language requests from MCP clients into Elasticsearch queries. It supports various interaction protocols including stdio, SSE, and streamable-HTTP, with streamable-HTTP being the recommended and more modern approach. Authentication is handled via API keys or basic username/password credentials.

Quick Start & Requirements

• Installation: Provided as a Docker image (docker.elastic.co/mcp/elasticsearch).
• Prerequisites: An Elasticsearch instance (versions 8.x and 9.x officially supported), Elasticsearch authentication credentials (API key or username/password).
• Running (stdio): docker run -i --rm -e ES_URL -e ES_API_KEY docker.elastic.co/mcp/elasticsearch stdio
• Running (http): docker run --rm -e ES_URL -e ES_API_KEY -p 8080:8080 docker.elastic.co/mcp/elasticsearch http
• Configuration: Environment variables ES_URL, ES_API_KEY (or ES_USERNAME, ES_PASSWORD), and optionally ES_SSL_SKIP_VERIFY.
• Docs: [Not explicitly linked, but usage is detailed in README.]

Highlighted Details

• Supports direct interaction with Elasticsearch indices through natural language.
• Offers a suite of tools for data exploration and querying within Elasticsearch.
• Provides multiple communication protocols (stdio, streamable-HTTP, SSE).

Maintenance & Community

• The project is marked as EXPERIMENTAL.
• Older versions (<= 0.3.1) installed via npm are deprecated.
• No community links (Discord, Slack, etc.) are provided in the README.

Licensing & Compatibility

• The license is not explicitly stated in the provided README snippet.
• Compatibility for commercial use or closed-source linking is not detailed.

Limitations & Caveats

This MCP server is explicitly marked as EXPERIMENTAL. Support for Elasticsearch versions prior to 8.x is not guaranteed. The ability to provide custom SSL certificates is planned for a future release.