mcp-elasticsearch

Elasticsearch MCP Server (Model Context Protocol) - read-only search only.

Features

Only exposes read-only operations:

• list_indices - List all indices

• get_mapping - Get index mapping

• search - Execute search/aggregation query

Related MCP server: Elasticsearch/OpenSearch MCP Server

Supports two transport modes

1. stdio (for local/standalone deployment)

python -m mcp_elasticsearch --transport stdio --url http://localhost:9200

2. sse (for remote/containerized deployment)

python -m mcp_elasticsearch --transport sse --host 0.0.0.0 --port 8002 --url http://elasticsearch:9200 [--api-key your-secret-key]

Environment variables

All command line arguments can also be set via environment variables:

• TRANSPORT - stdio or sse (default: stdio)

• HOST - bind host for sse mode (default: 0.0.0.0)

• PORT - bind port for sse mode (default: 8002)

• ELASTICSEARCH_URL - Elasticsearch URL

• API_KEY - Optional API key for client authentication

Docker

FROM python:3.11-slim

WORKDIR /app

COPY pyproject.toml poetry.lock ./
RUN poetry install --no-dev --no-root

COPY mcp_elasticsearch/ ./mcp_elasticsearch/

EXPOSE 8002

CMD ["python", "-m", "mcp_elasticsearch"]