Servidor MCP de Elasticsearch 7.x

Un servidor MCP para Elasticsearch 7.x, que proporciona compatibilidad con las versiones de Elasticsearch 7.x.

Características

Proporciona una interfaz de protocolo MCP para interactuar con Elasticsearch 7.x
Admite operaciones básicas de Elasticsearch (ping, información, etc.)
Admite una funcionalidad de búsqueda completa, incluidas consultas de agregación, resaltado, clasificación y otras funciones avanzadas.
Acceda fácilmente a la funcionalidad de Elasticsearch a través de cualquier cliente MCP

Requisitos

Python 3.10+
Elasticsearch 7.x (se recomienda 7.17.x)

Instalación

Instalación mediante herrería

Para instalar Elasticsearch 7.x MCP Server para Claude Desktop automáticamente a través de Smithery :

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

Instalación manual

pip install -e .

Variables de entorno

El servidor requiere las siguientes variables de entorno:

ELASTIC_HOST : Dirección de host de Elasticsearch (por ejemplo, http://localhost:9200 )
ELASTIC_USERNAME : nombre de usuario de Elasticsearch
ELASTIC_PASSWORD : Contraseña de Elasticsearch
MCP_PORT : (opcional) Puerto de escucha del servidor MCP, predeterminado 9999

Uso de Docker Compose

Cree un archivo .env y configure ELASTIC_PASSWORD :

ELASTIC_PASSWORD=your_secure_password

Iniciar los servicios:

docker-compose up -d

Esto iniciará un clúster Elasticsearch 7.17.10 de tres nodos, Kibana y el servidor MCP.

Uso de un cliente MCP

Puede utilizar cualquier cliente MCP para conectarse al servidor MCP:

from mcp import MCPClient

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

Documentación de la API

Métodos MCP admitidos actualmente:

es-ping : comprobar la conexión de Elasticsearch
es-info : Obtener información del clúster de Elasticsearch
es-search : Buscar documentos en el índice de Elasticsearch

Ejemplos de API de búsqueda

Búsqueda básica

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

Consulta de agregación

# 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"
            }
        }
    }
})

Búsqueda avanzada

# 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"]
})

Desarrollo

Clonar el repositorio
Instalar dependencias de desarrollo
Ejecute el servidor: elasticsearch7-mcp-server

Licencia

[Licencia en archivo LICENSE]

Lengua china

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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.

Tools

Proporciona una interfaz de protocolo MCP para interactuar con bases de datos Elasticsearch 7.x, admitiendo una funcionalidad de búsqueda integral que incluye agregaciones, resaltado y clasificación.

Related Resources

Reddit Discussion about this server

Related MCP Servers

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 -
6
127
Python
Apache 2.0
Elasticsearch Semantic Search MCP Server
jedrazb
-
security
F
license
-
quality
A Python MCP server that enables semantic search through Search Labs blog posts indexed in Elasticsearch, allowing Claude to intelligently retrieve relevant information from the blog content.
Last updated -
Python
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
565
241
JavaScript
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
105
7
TypeScript
MIT License

View all related MCP servers

Elasticsearch 7.x MCP Server