# es-mcp-server

**Repository Path**: luckymxp/es-mcp-server

## Basic Information

- **Project Name**: es-mcp-server
- **Description**: es-mcp-server
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-20
- **Last Updated**: 2026-01-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ES MCP Server

This is an Elasticsearch MCP (Model Context Protocol) Server built with FastAPI. It provides tools for searching Elasticsearch, executing ES|QL queries, and RAG retrieval.

## Features

- Elasticsearch search tool
- ES|QL query execution
- RAG document retrieval (optional)

## Installation

1. Install dependencies:
   ```bash
   pip install -r requirements.txt
   ```

2. Configure Elasticsearch connection in `app/config.py` or via environment variables.

## Usage

Run the server:
```bash
uvicorn app.main:app --reload
```

The server will be available at `http://localhost:8000`.

## API Endpoints

- `GET /`: Root endpoint
- `POST /tools/es_search`: Execute Elasticsearch search
- `POST /tools/esql_query`: Execute ES|QL query
- `POST /tools/rag_retrieve`: Retrieve documents for RAG