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.

Integrations

Utilizes environment variables through .env files to configure connection details for Elasticsearch, including host address, authentication credentials, and server port settings.
Enables interaction with Elasticsearch 7.x instances, supporting basic operations like ping and info, as well as complete search functionality including aggregation queries, highlighting, sorting, and other advanced search features.
Supports connection to Kibana as part of an Elasticsearch deployment through the Docker Compose setup, providing visualization and management capabilities for Elasticsearch data.

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.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

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