Advertise
MCP.so
Sign In

Elasticsearch MCP Server

@awesimon

Repository

Basic information

Category

Databases

License

MIT

Transports

stdio

Author

awesimon

About Elasticsearch MCP Server

Elasticsearch MCP server with available features including mappings management, search and indexing, and index management etc.

#elasticsearch#mcp#mcp-server

Elasticsearch MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "elasticsearch-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@awesome-ai/elasticsearch-mcp"
      ],
      "env": {
        "ES_HOST": "your-elasticsearch-host",
        "ES_API_KEY": "your-api-key"
      }
    }
  }
}

Elasticsearch MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Elasticsearch MCP Server?

A Model Context Protocol server that connects MCP Clients—such as Claude Desktop or Cursor—to an Elasticsearch cluster, enabling users to interact with their indices and data through natural language conversations.

How to use Elasticsearch MCP Server?

Configure your MCP Client using npx with the published npm package (@awesome-ai/elasticsearch-mcp), providing your Elasticsearch host and authentication credentials via environment variables (ES_HOST, ES_API_KEY or ES_USERNAME/ES_PASSWORD). After setup, the server connects automatically, and you can query your cluster using everyday language.

Key features of Elasticsearch MCP Server

  • Check cluster health with optional index-level details
  • List, create, and reindex Elasticsearch indices
  • Get and create field mappings for indices
  • Search Elasticsearch with query DSL
  • Bulk-import data into an index
  • Create, list, and delete index templates

Use cases of Elasticsearch MCP Server

  • Ask for the health status and active node count of your cluster
  • List all indices or create new ones with custom settings and mappings
  • Reindex data from one index to another
  • Retrieve field mappings and add new fields to existing indices
  • Perform natural language searches on your Elasticsearch data
  • Manage index templates for automated index configuration

Frequently asked questions

1

What do I need to run Elasticsearch MCP Server?

You need a running Elasticsearch instance, authentication credentials (an API key or a username/password pair), and an MCP Client such as Claude Desktop or Cursor.

2

How do I authenticate with my Elasticsearch cluster?

You must provide either an `ES_API_KEY` or both `ES_USERNAME` and `ES_PASSWORD` via environment variables. The configuration accepts legacy variable names as fallbacks.

3

Can I connect to multiple Elasticsearch nodes?

Yes. Set the `ES_HOST` environment variable to a comma-separated list of node URLs. The client automatically handles failover and load balancing across the configured nodes.

4

How do I run the server from source for development?

Clone the repository, install dependencies (`npm install`), build the project (`npm run build`), then point your MCP Client configuration to the built `dist/index.js` file using the `node` command.

5

Is there a way to debug or test the server locally?

Yes, use the MCP Inspector. Run `ES_HOST=your-url ES_API_KEY=your-key npm run inspector`, then access the inspector UI at `http://127.0.0.1:6274` to inspect requests and responses.

Comments

More Databases MCP servers

Multi Database MCP Server

FreePeak

A powerful multi-database server implementing the Model Context Protocol (MCP) to provide AI assistants with structured access to databases.

397

Chroma MCP Server

chroma-core

A Model Context Protocol (MCP) server implementation that provides database capabilities for Chroma

569

MySQL MCP Server

designcomputer

A Model Context Protocol (MCP) server that enables secure interaction with MySQL databases

1.3K

PostgreSQL

modelcontextprotocol

Model Context Protocol Servers

88.1K

Schemity

tbson

Local database MCP server: your agent sees a migration's impact before it runs, for PostgreSQL, MySQL, SQL Server and SQLite, with no database credentials.

Advertise