What is Mcp Server Elasticsearch

mcp-server-elasticsearch is a Model Context Protocol server designed for managing Elasticsearch clusters. It allows Large Language Models (LLMs) to manage indices and execute queries effectively.

Use cases

Use cases include searching for documents in large datasets, creating and managing indices for structured data, and integrating with applications that utilize Elasticsearch for backend data processing.

How to use

To use mcp-server-elasticsearch, integrate it into your Claude Desktop configuration by adding it to the ‘mcpServers’ section of your ‘claude_desktop_config.json’. You can also run it using Docker with the provided command.

Key features

Key features include executing search queries, creating new indices, listing available indices, and indexing documents. It also provides mapping information for each index automatically discovered from metadata.

Where to use

mcp-server-elasticsearch is suitable for applications that require efficient data retrieval and management in Elasticsearch, such as data analytics, search engines, and content management systems.

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.