Octodet Elasticsearch MCP Server

Octodet Elasticsearch MCP Server is an MCP server that provides tools for interacting directly with Elasticsearch clusters through the Model Context Protocol. It connects LLM-based tools and developer environments to Elasticsearch versions 8 and 9, allowing software developers, data engineers, and administrators to manage distributed search data. The server enables users to perform full CRUD operations on individual documents, execute complex DSL search queries with highlighting, run bulk operations, and update or delete documents via scripted queries. In addition to document operations, it supports index administration, including creating and deleting indices, reading mappings, inspecting index templates, and retrieving aliases. It also provides administrative tools to monitor cluster health and analyze shard allocations across nodes. By standardizing these actions over MCP, it allows client applications such as Claude Desktop and VS Code to inspect and modify search indices without leaving the development workflow.

Category: Databases & Data Stores

Tags: elasticsearch, indexing, nosql, search

Visit Octodet Elasticsearch MCP Server

How to install and configure Octodet Elasticsearch MCP Server

Follow these steps to install and configure Octodet Elasticsearch MCP Server in your client: 1. Ensure you have Node.js and npm installed. 2. To run directly via npx, add the server to your Claude Desktop or VS Code configuration under mcpServers or mcp.servers: json { "mcpServers": { "elasticsearch": { "command": "npx", "args": ["-y", "@octodet/elasticsearch-mcp"], "env": { "ES_URL": "http://localhost:9200", "ES_API_KEY": "your_api_key", "ES_VERSION": "8" } } } } 3. Alternatively, install globally using npm install -g @octodet/elasticsearch-mcp or clone the repository and run npm install followed by npm run build. 4. Restart your MCP client to load the configuration and verify the server tools are available.

What you can do with Octodet Elasticsearch MCP Server

• Running complex DSL queries across indices to analyze search hits, relevance scores, and field highlighting directly from an LLM interface. - Performing bulk indexing, updates, or deletions of Elasticsearch documents in a single operation to optimize cluster ingestion performance. - Modifying or purging historical documents across large datasets using queries and custom scripts via update-by-query or delete-by-query tools. - Monitoring cluster health status, shard allocation, and index distribution to diagnose performance issues and node balancing. - Inspecting index field mappings, aliases, and templates to verify schema configurations and prepare new search indices.

Key facts

• Open Source
• https://github.com/Octodet/elasticsearch-mcp
• Databases & Data Stores, Web Search & Research
• elasticsearch, indexing, nosql, search

Part of MCP Servers

How do I install Octodet Elasticsearch MCP Server?

You can run Octodet Elasticsearch MCP Server directly using npx by specifying @octodet/elasticsearch-mcp in your client configuration. Alternatively, install it globally via npm using the command npm install -g @octodet/elasticsearch-mcp, or clone the GitHub repository, install the dependencies, and build the project locally using npm run build.

What can Octodet Elasticsearch MCP Server do?

The server exposes 16 tools covering full document and index lifecycle management. It allows users to search with query DSL, add, update, and delete documents, perform bulk operations, execute scripted queries, create or delete indices, read mappings and aliases, and check cluster health and shard states.

Which MCP clients work with Octodet Elasticsearch MCP Server?

The server works with any client supporting the Model Context Protocol, including Claude Desktop and the VS Code MCP extension. It connects via stdio by executing npx or a local Node.js script alongside cluster environment variables like ES_URL and ES_API_KEY.

Is Octodet Elasticsearch MCP Server open source?

Yes, Octodet Elasticsearch MCP Server is open source software. The source code, installation instructions, and configuration details are hosted publicly in the Octodet/elasticsearch-mcp repository on GitHub.

Which Elasticsearch versions are supported?

Octodet Elasticsearch MCP Server supports Elasticsearch version 8 and version 9. You can configure the target version by defining the ES_VERSION environment variable in your client configuration settings, with version 8 configured as the default.