elastic-mcp

Akhilvis/elastic-mcp

3.2

If you are the rightful owner of elastic-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Elastic MCP allows you to connect to your Elasticsearch cluster using the Model Context Protocol (MCP), enabling natural language interactions with your data.

Tools

  1. search_index

    Search an index with a query string.

  2. list_indices

    List all indices (excluding system indices).

  3. get_index_mappings

    Get mappings for a specific index.

Demo

https://github.com/user-attachments/assets/907c3f6f-807c-4805-879a-649c74804c29

Elastic MCP

Connect to your Elasticsearch cluster from any MCP-compatible client (such as Claude Desktop) using the Model Context Protocol (MCP). This server exposes your Elasticsearch data and operations via the MCP interface, enabling agents and applications to query, manage, and analyze your data through natural language interactions.

1. Setup

Prerequisites

  • Python 3.8+
  • Elasticsearch running and accessible
  • uv or pip for dependency management

Install dependencies

Using uv package manager:

uv pip install -r requirements.txt

2. Running the MCP Server

Test using MCP Inspector

ELASTIC_URL="http://localhost:9200" ELASTIC_USERNAME="your_username" ELASTIC_PASSWORD="your_password" fastmcp dev tools/elastic_tool.py

or

Run the mcp server by

ELASTIC_URL="http://localhost:9200" ELASTIC_USERNAME="elastic" ELASTIC_PASSWORD="hKsXqDsd" python3 tools/elastic_tool.py

and run mcp client in another terminal by

python3 mcp_client.py

or

Add to the Claude Desktop by editing the claude_desktop_config.json and add the following code snippet


{
  "mcpServers": {
    "Elastic MCP Server": {
      "command": "uv",
      "args": [
        "run",
        "--with-requirements",
        "<absolute path to requirements.txt>",
        "fastmcp",
        "run",
        "<absolute path to elastic_tool.py>"
      ],
      "env": {
        "ELASTIC_URL": "http://localhost:9200",
        "ELASTIC_USERNAME": "your_username",
        "ELASTIC_PASSWORD": "your_password"
      }
    }
  }
}

3. Tools Provided

  • search_index: Search an index with a query string.
  • list_indices: List all indices (excluding system indices).
  • get_index_mappings: Get mappings for a specific index.

4. License

MIT License

5. Notes