Servidor MCP de Elasticsearch 7.x

insignia de herrería

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

Related MCP server: Elasticsearch MCP Server

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