MCP Elasticsearch Server 🔍

A Model Context Protocol (MCP) server that provides Elasticsearch integration capabilities to AI assistants and other MCP clients. This server enables querying Elasticsearch clusters through a standardized interface.

Features

- 🔐 Multiple Authentication Methods: Supports both API key and username/password authentication
- 📊 Index Management: List indices with health status and document counts
- 🗺️ Schema Discovery: Retrieve field mappings to understand index structure
- 🔍 Advanced Search: Execute complex Elasticsearch queries with aggregations and sorting
- 📋 Structured Responses: JSON-formatted output with search metadata
- ⚡ Performance Monitoring: Query execution time tracking
- 🎯 Context Aware: Supports search execution with proper context cancellation

Tools

list_indices

List all Elasticsearch indices with optional pattern filtering.

Parameters:
- pattern (string, optional): Index pattern filter (default: "*")

Returns:
- Total index count
- Index details (name, health, status, document count, size)

get_index_mappings

Get field mappings for one or more Elasticsearch indices.

Parameters:
- index (string, required): Index name or pattern

Returns:
- Complete field mappings for the specified indices

search

Execute Elasticsearch search queries with full DSL support.

Parameters:
- index (string, required): Index name or pattern to search
- query (string, optional): Elasticsearch query DSL as JSON (default: "{}")
- size (number, optional): Maximum documents to return (default: 10, max: 10000)
- sort (string, optional): Sort specification as JSON
- track_total_hits (boolean, optional): Track total hit count (default: true)

Returns:
- Search results with hits, aggregations, and metadata

Configuration

Environment Variables

Elasticsearch Configuration

- ES_URL: Elasticsearch cluster URL (required) - ES_API_KEY: API key for authentication (optional) - ES_USERNAME: Username for basic authentication (optional) - ES_PASSWORD: Password for basic authentication (optional)

Server Configuration

- MCP_ES_SERVER_NAME: Server name (default: "mcp-elasticsearch 🔍")

Logging Configuration

- MCP_ES_LOG_LEVEL: Log level (debug, info, warn, error, fatal) - MCP_ES_LOG_FORMAT: Log format (json, console) - MCP_ES_LOG_OUTPUT: Log output (stdout, stderr)

Authentication

You must provide either:
1. API Key authentication: Set ES_API_KEY
2. Basic authentication: Set both ES_USERNAME and ES_PASSWORD

Installation

```bash