mcp-elasticsearch

Overview

This MCP server provides seamless integration with Elasticsearch clusters, offering a complete set of tools for cluster operations, index management, document operations, search capabilities, and bulk operations. It supports multiple protocols (stdio, HTTP, and deprecated SSE) and is compatible with Elasticsearch versions 7, 8, and 9. The server can be deployed via Docker, compiled from source, or integrated into desktop applications like Claude Desktop and Cursor with comprehensive configuration options.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• es_cluster_info

  Get cluster information and version details

  Try:Get Elasticsearch cluster informationTry:What version of Elasticsearch is running?
• es_cluster_health

  Get cluster health status and metrics

  Try:Check cluster health statusTry:Is the Elasticsearch cluster healthy?
• es_index_create

  Create new indices with settings and mappings

  Try:Create a new index called 'products'Try:Make an index with mapping for user profiles
• es_index_delete

  Delete existing indices

  Try:Delete the old-logs indexTry:Remove the temporary-test index
• es_index_exists

  Check if an index exists

  Try:Does the 'users' index exist?Try:Check if products index is available
• es_index_list

  List all indices with metadata

  Try:Show me all indicesTry:List available Elasticsearch indices
• es_document_index

  Index documents with optional ID

  Try:Add a new document to the products indexTry:Index user profile document with ID 'user123'
• es_document_get

  Retrieve documents by ID

  Try:Get document with ID 'doc456'Try:Retrieve product document 789
• es_document_update

  Update existing documents

  Try:Update document with ID 'user123'Try:Modify product details for item 456
• es_document_delete

  Delete documents by ID

  Try:Delete document with ID 'old-doc-789'Try:Remove user profile 'user123'
• es_search

  Execute search queries with filters, sorting, and field selection

  Try:Search for products with 'wireless' in the nameTry:Find users registered in the last month
• es_bulk

  Execute multiple operations in a single request

  Try:Bulk import 100 productsTry:Update multiple user documents in one operation

Comparable tools

Installation

docker run -d -p 8080:8080 \
  -e MCP_PROTOCOL=http \
  -e ES_ADDRESSES=http://your-elasticsearch:9200 \
  ghcr.io/aeazer/mcp-elasticsearch:latest

go install github.com/AeaZer/mcp-elasticsearch@latest

{
  "mcpServers": {
    "elasticsearch": {
      "command": "mcp-elasticsearch",
      "env": {
        "ES_ADDRESSES": "http://localhost:9200",
        "ES_VERSION": "8"
      }
    }
  }
}

FAQ

Which Elasticsearch versions are supported?

This server is compatible with Elasticsearch versions 7, 8, and 9.

What authentication methods are supported?

Supports basic authentication (username/password), API keys, and Elastic Cloud authentication.

Compare mcp-elasticsearch with