OpenSearch MCP Server

@loupipalien

About OpenSearch MCP Server

Config

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

{
  "mcpServers": {
    "opensearch-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/loupipalien/opensearch-mcp-server",
        "opensearch-mcp-server"
      ],
      "env": {
        "OPENSEARCH_HOSTS": "your_opensearch_cluster_hosts",
        "OPENSEARCH_USERNAME": "your_opensearch_cluster_username",
        "OPENSEARCH_PASSWORD": "your_opensearch_cluster_password"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is OpenSearch MCP Server?

An MCP server that lets you interact with an OpenSearch cluster using natural language from any MCP client (Cursor, Cline, etc.). It provides tools for cluster health analysis, document bulk operations, index management, and search.

How to use OpenSearch MCP Server?

Install Python 3.10+ and uv. Add the server configuration to your MCP settings file, setting the environment variables OPENSEARCH_HOSTS, OPENSEARCH_USERNAME, and OPENSEARCH_PASSWORD. Run via remote repo using uvx or from a local repo using uv. For testing, you can start a 2‑node Docker cluster with the provided docker-compose.yml.

Key features of OpenSearch MCP Server?

Get cluster health and statistics
Bulk document operations to indices
Create, delete, and list indices
Retrieve index mappings and info
Search with query DSL
Natural language queries via MCP clients

Use cases of OpenSearch MCP Server?

Monitor cluster health via conversational commands
Bulk index large datasets into OpenSearch
Automate index creation and deletion tasks
Search documents using complex queries
Retrieve index mappings for schema inspection

FAQ from OpenSearch MCP Server

What are the prerequisites?

Python 3.10 or higher and uv must be installed.

How do I configure authentication?

Set the environment variables OPENSEARCH_USERNAME and OPENSEARCH_PASSWORD in your MCP settings file.

Can I connect to multiple OpenSearch hosts?

Yes. Separate host addresses with commas in the OPENSEARCH_HOSTS environment variable.

How can I start a local OpenSearch cluster for testing?

Run export OPENSEARCH_INITIAL_ADMIN_PASSWORD=your_password then docker-compose up -d. Default credentials: admin / your_opensearch_cluster_password.

What license does this project use?

Apache v2.0 License.

Frequently asked questions

What are the prerequisites?

Python 3.10 or higher and [uv](https://github.com/astral-sh/uv) must be installed.

How do I configure authentication?

Set the environment variables `OPENSEARCH_USERNAME` and `OPENSEARCH_PASSWORD` in your MCP settings file.

Can I connect to multiple OpenSearch hosts?

Yes. Separate host addresses with commas in the `OPENSEARCH_HOSTS` environment variable.

How can I start a local OpenSearch cluster for testing?

Run `export OPENSEARCH_INITIAL_ADMIN_PASSWORD=your_password` then `docker-compose up -d`. Default credentials: `admin` / `your_opensearch_cluster_password`.