Elasticsearch 7.x MCP 서버

Elasticsearch 7.x MCP Server

An MCP server for Elasticsearch 7.x, providing compatibility with Elasticsearch 7.x versions.

Features

Provides an MCP protocol interface for interacting with Elasticsearch 7.x
Supports basic Elasticsearch operations (ping, info, etc.)
Supports complete search functionality, including aggregation queries, highlighting, sorting, and other advanced features
Easily access Elasticsearch functionality through any MCP client

Requirements

Python 3.10+
Elasticsearch 7.x (7.17.x recommended)

Installation

Installing via Smithery

To install Elasticsearch 7.x MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @imlewc/elasticsearch7-mcp-server --client claude

Manual Installation

pip install -e .

Environment Variables

The server requires the following environment variables:

ELASTIC_HOST: Elasticsearch host address (e.g., http://localhost:9200)
ELASTIC_USERNAME: Elasticsearch username
ELASTIC_PASSWORD: Elasticsearch password
MCP_PORT: (Optional) MCP server listening port, default 9999

Using Docker Compose

Create a .env file and set ELASTIC_PASSWORD:

ELASTIC_PASSWORD=your_secure_password

Start the services:

docker-compose up -d

This will start a three-node Elasticsearch 7.17.10 cluster, Kibana, and the MCP server.

Using an MCP Client

You can use any MCP client to connect to the MCP server:

from mcp import MCPClient

client = MCPClient("localhost:9999")
response = client.call("es-ping")
print(response)  # {"success": true}

API Documentation

Currently supported MCP methods:

es-ping: Check Elasticsearch connection
es-info: Get Elasticsearch cluster information
es-search: Search documents in Elasticsearch index

Search API Examples

Basic Search

# Basic search
search_response = client.call("es-search", {
    "index": "my_index",
    "query": {
        "match": {
            "title": "search keywords"
        }
    },
    "size": 10,
    "from": 0
})

Aggregation Query

# Aggregation query
agg_response = client.call("es-search", {
    "index": "my_index",
    "size": 0,  # Only need aggregation results, no documents
    "aggs": {
        "categories": {
            "terms": {
                "field": "category.keyword",
                "size": 10
            }
        },
        "avg_price": {
            "avg": {
                "field": "price"
            }
        }
    }
})

Advanced Search

# Advanced search with highlighting, sorting, and filtering
advanced_response = client.call("es-search", {
    "index": "my_index",
    "query": {
        "bool": {
            "must": [
                {"match": {"content": "search term"}}
            ],
            "filter": [
                {"range": {"price": {"gte": 100, "lte": 200}}}
            ]
        }
    },
    "sort": [
        {"date": {"order": "desc"}},
        "_score"
    ],
    "highlight": {
        "fields": {
            "content": {}
        }
    },
    "_source": ["title", "date", "price"]
})

Development

Clone the repository
Install development dependencies
Run the server: elasticsearch7-mcp-server

License

[License in LICENSE file]

中文文档

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Elasticsearch 7.x 데이터베이스와 상호 작용하기 위한 MCP 프로토콜 인터페이스를 제공하며, 집계, 강조 표시, 정렬을 포함한 포괄적인 검색 기능을 지원합니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Search1API MCP Server
fatwang2
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that provides search and crawl functionality using Search1API.
Last updated -
5
760
148
TypeScript
MIT License
Elasticsearch MCP Server
cr7258
A
security
A
license
A
quality
Facilitates interaction with Elasticsearch clusters by allowing users to perform index operations, document searches, and cluster management via a Model Context Protocol server and natural language commands.
Last updated -
16
192
Python
Apache 2.0
Elasticsearch MCP Serverofficial
elastic
A
security
A
license
A
quality
Connects Claude and other MCP clients to Elasticsearch data, allowing users to interact with their Elasticsearch indices through natural language conversations.
Last updated -
3
1,621
406
Rust
Apache 2.0
Elasticsearch MCP Server
awesimon
A
security
A
license
A
quality
Connects agents to Elasticsearch data using the Model Context Protocol, allowing natural language interaction with Elasticsearch indices through MCP Clients like Claude Desktop and Cursor.
Last updated -
11
175
12
TypeScript
MIT License

View all related MCP servers

Elasticsearch 7.x MCP Server

Elasticsearch 7.x MCP Server

Features

Requirements

Installation

Installing via Smithery

Manual Installation

Environment Variables

Using Docker Compose

Using an MCP Client

API Documentation

Search API Examples

Basic Search

Aggregation Query

Advanced Search

Development

License

Related Resources

Related MCP Servers

Search1API MCP Server

Elasticsearch MCP Server

Elasticsearch MCP Serverofficial

Elasticsearch MCP Server

Appeared in Searches

MCP directory API