OpenSearch MCP Server

@seohyunjun

About OpenSearch MCP Server

OpenSearch MCP Server: Open-source search cluster management component

Config

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

{
  "mcpServers": {
    "opensearch": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/src/opensearch_mcp_server",
        "run",
        "opensearch-mcp-server"
      ],
      "env": {
        "OPENSEARCH_HOST": "https://localhost:9200",
        "OPENSEARCH_USERNAME": "opensearch",
        "OPENSEARCH_PASSWORD": "test123",
        "DASHBOARDS_HOST": "https://localhost:5601"
      }
    }
  }
}

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?

OpenSearch MCP Server is a Model Context Protocol (MCP) server implementation that provides OpenSearch interaction, enabling searching documents, analyzing indices, and managing a cluster through a set of tools. It is a fork of the Elasticsearch MCP Server converted to work with OpenSearch.

How to use OpenSearch MCP Server?

Clone the repository, then configure Claude Desktop’s config file (claude_desktop_config.json) with the uv command pointing to the local source directory. Set environment variables OPENSEARCH_HOST, OPENSEARCH_USERNAME, OPENSEARCH_PASSWORD, and DASHBOARDS_HOST. Restart Claude Desktop to load the server.

Key features of OpenSearch MCP Server

List all indices in the OpenSearch cluster.
Retrieve mapping configuration for a specific index.
Get settings configuration for a specific index.
Search documents using OpenSearch Query DSL.
Get health status of the cluster.
Get statistical information about the cluster.

Use cases of OpenSearch MCP Server

Query documents in an OpenSearch index via natural language.
Monitor cluster health and statistics through an AI assistant.
Explore index mappings and settings without the Dev Tools console.
Automate index management tasks using conversational commands.

FAQ from OpenSearch MCP Server

How does OpenSearch MCP Server authenticate to the OpenSearch cluster?

Authentication is handled via environment variables OPENSEARCH_USERNAME and OPENSEARCH_PASSWORD. The server uses these credentials to connect to the host specified in OPENSEARCH_HOST.

What are the runtime dependencies?

The server requires uv (Python package manager) and the source code cloned from the repository. No additional system-wide installations are described beyond a Python environment.

Can I run the server without a local Docker cluster?

The README shows starting an OpenSearch cluster with Docker Compose, but the server itself only requires a reachable OpenSearch host. You can point it at any existing cluster by configuring the environment variables.

Does the server support OpenSearch Dashboards?

Yes, it includes a DASHBOARDS_HOST environment variable to connect to Dashboards (Kibana equivalent) for UI access.

What transport and security options are available?

The server uses MCP (stdio-based) transport. Security is provided by the username/password authentication sent over HTTPS (the example uses https://localhost:9200).

Frequently asked questions

How does OpenSearch MCP Server authenticate to the OpenSearch cluster?

Authentication is handled via environment variables `OPENSEARCH_USERNAME` and `OPENSEARCH_PASSWORD`. The server uses these credentials to connect to the host specified in `OPENSEARCH_HOST`.

What are the runtime dependencies?

The server requires `uv` (Python package manager) and the source code cloned from the repository. No additional system-wide installations are described beyond a Python environment.

Can I run the server without a local Docker cluster?

Does the server support OpenSearch Dashboards?

Yes, it includes a `DASHBOARDS_HOST` environment variable to connect to Dashboards (Kibana equivalent) for UI access.

What transport and security options are available?

The server uses MCP (stdio-based) transport. Security is provided by the username/password authentication sent over HTTPS (the example uses `https://localhost:9200`).

Comments

Basic information

More Databases MCP servers

MCP Server for Milvus

zilliztech

Model Context Protocol Servers for Milvus

235

Neon MCP Server

neondatabase

MCP server for interacting with Neon Management API and databases

617

MCP Server for MySQL based on NodeJS

benborla

A Model Context Protocol server that provides read-only access to MySQL databases. This server enables LLMs to inspect database schemas and execute read-only queries.

1.9K

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

MongoDB Lens

furey

🍃🔎 MongoDB Lens: Full Featured MCP Server for MongoDB Databases

204