Unofficial Elasticsearch MCP Server

@zx8086

About 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.

Config

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

{
  "mcpServers": {
    "mcp-server-elasticsearch-zx8086": {
      "command": "npx",
      "args": [
        "@elastic/mcp-server-elasticsearch"
      ]
    }
  }
}

Tools

No tools detected

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

Overview

What is Unofficial Elasticsearch MCP Server?

A production-ready Model Context Protocol (MCP) server that connects AI assistants like Claude Desktop to Elasticsearch clusters. It provides 60+ Elasticsearch operations through natural language interactions, built on the Bun runtime for optimal performance and featuring advanced configuration management and security controls.

How to use Unofficial Elasticsearch MCP Server?

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.

Key features of Unofficial Elasticsearch MCP Server

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

Use cases of Unofficial Elasticsearch MCP Server

Natural language querying of Elasticsearch indices and mappings
Monitoring cluster health, node stats, and shard distributions
Performing production-safe read-only analytics and data exploration
Managing index templates, aliases, ILM policies, and enrich policies
Executing bulk document operations and complex SQL queries

FAQ from Unofficial Elasticsearch MCP Server

What runtime is required?

Bun is the recommended runtime; Node.js 18+ is also supported for npm compatibility.

Which Elasticsearch versions are supported?

Elasticsearch version 7.x or higher, with 8.x+ strongly recommended.

How do I authenticate to Elasticsearch?

Use either an API key (ES_API_KEY) or username/password (ES_USERNAME and ES_PASSWORD).

What transport modes are available?

Standard input/output (stdio) is the default; Server-Sent Events (sse) on port 8080 is also configurable.

Does the server support safe production monitoring?

Yes – enable read-only mode with READ_ONLY_MODE=true and strict mode to block all destructive operations, or warning mode to allow them with logged warnings.

Frequently asked questions

What runtime is required?

Bun is the recommended runtime; Node.js 18+ is also supported for npm compatibility.

Which Elasticsearch versions are supported?

Elasticsearch version 7.x or higher, with 8.x+ strongly recommended.

How do I authenticate to Elasticsearch?

Use either an API key (`ES_API_KEY`) or username/password (`ES_USERNAME` and `ES_PASSWORD`).

What transport modes are available?

Standard input/output (`stdio`) is the default; Server-Sent Events (`sse`) on port 8080 is also configurable.

Does the server support safe production monitoring?

Yes – enable read-only mode with `READ_ONLY_MODE=true` and strict mode to block all destructive operations, or warning mode to allow them with logged warnings.

Comments

Basic information

More Databases MCP servers

Lawstronaut

Lawstronaut-FZCO

Access millions of official legal and regulatory source documents from 155+ jurisdictions via MCP. Lawstronaut supports AI agents with structured legal research, legal data, laws, regulations, cases, guidance, official s