mcp-server-elasticsearch

Elasticsearch

A Model Context Protocol server for Elasticsearch clusters. Enables LLMs to manage indices and execute queries.

IMPORTANT NOTE : this was built mainly by feeding examples to claude from the postgres mcp server.

Components

Tools

• search

  • Execute search queries against indices
  • Input:
    • index (string): Target index name
    • query (object): Elasticsearch query DSL
  • Returns search hits

• create_index

  • Create new Elasticsearch indices
  • Input:
    • index (string): Index name
    • mappings (object, optional): Index mappings configuration
    • settings (object, optional): Index settings configuration

• list_indices

  • List all available indices
  • No input required
  • Returns array of index information

• index_document

  • Index a document
  • Input:
    • index (string): Target index name
    • id (string, optional): Document ID
    • document (object): Document content
  • Returns indexing operation result

Resources

The server provides mapping information for each index:

• Index Mappings (elasticsearch://<host>/<index>/schema)
  • JSON mapping information
  • Field names, types and configurations
  • Automatically discovered from metadata

Usage with Claude Desktop

Add to the "mcpServers" section of your claude_desktop_config.json:

{
  "mcpServers": {
    "elasticsearch": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-elasticsearch",
        "http://localhost:9200"
      ]
    }
  }
}

Docker one liner to run container :

docker run -d --name elasticsearch -p 9200:9200 -p 9300:9300 -e "discovery.type=single-node" -e "xpack.security.enabled=false" docker.elastic.co/elasticsearch/elasticsearch:8.11.3

Replace the URL with your Elasticsearch endpoint.

License

Licensed under MIT License. Free to use, modify, and distribute. See LICENSE file for details.