Elasticsearch MCP Server

🚀 Elasticsearch

Provide a Model Context Protocol (MCP) server for Elasticsearch clusters, enabling LLMs to manage indexes and execute queries.

⚠️ Important Note

This implementation is mainly completed by inputting examples from the PostgreSQL MCP server into Claude.

✨ Features

Tools

• Search

  • Execute a search query on the target index.
  • Input:
    • index (string): Name of the target index.
    • query (object): Elasticsearch Query DSL.
  • Returns search results.

• Create Index

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

• List Indexes

  • List all available indexes.
  • No input required.
  • Returns an array of index information.

• Index Document

  • Index a document into the specified index.
  • Input:
    • index (string): Name of the target index.
    • id (string, optional): Document ID.
    • document (object): Document content.
  • Returns the result of the indexing operation.

Resources

The server provides mapping information for each index:

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

📦 Installation

Using Claude Desktop

Add the following content to the mcpServers section of the claude_desktop_config.json file:

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

Using Docker

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

This project is released under the MIT License. You are free to use, modify, and distribute it. See the LICENSE file for details.