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

Related MCP server: OpenSearch MCP Server

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.