Skip to main content
Glama
mcp-OpenSearch

mcp-OpenSearch

by showjason

OpenSearch MCP Server

MCP (Model Context Protocol) server for OpenSearch integration which is inspired by elasticsearch-mcp-server.

Features

  • Index Management Tools:

    • List all indices in OpenSearch cluster

    • Get index mapping

    • Get index settings

  • Cluster Management Tools:

    • Get cluster health status

    • Get cluster statistics

  • Document Tools:

    • Search documents

Related MCP server: Elastic MCP Server

Installation

# Clone the repository
git clone https://github.com/your-username/opensearch-mcp-server.git
cd opensearch-mcp-server

# Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install the package
pip install uv
uv pip install -e .

Configuration

Create a .env file in the root directory with the following variables:

OPENSEARCH_HOST=https://localhost:9200
OPENSEARCH_USERNAME=xxxx
OPENSEARCH_PASSWORD=xxxx

Adjust the values to match your OpenSearch configuration.

Usage with Cursor

Run the MCP server:

uv run opensearch-mcp-server --port=<port>

Integrate with Cursor

{
  "mcpServers": {
    "opensearch": {
      "url": "http://<host>:<port>>/sse"
    }
  }
}

Usage with Claude Desktop APP

{
  "mcpServers": {
    "opensearch": {
      "command": "uv",
      "args": [
          "--directory",
          "/absolute/path/to/opensearch-mcp-server",
          "run",
          "opensearch-mcp-server"
      ]
    }
  }
}

Development

# Install dependencies
uv pip install -e .

# Run tests
uv run pytest -vv -s test_opensearch.py

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables AI agents to interact with INFINI Easysearch (compatible with Elasticsearch/OpenSearch APIs) through 121 tools covering cluster management, index operations, document manipulation, search queries, snapshots, and monitoring.
      100
      4
      MIT
    • F
      license
      B
      quality
      Not graded
      maintenance
      Provides comprehensive tools for managing Elasticsearch clusters, including security management, search operations, and index administration. It enables users to monitor cluster health, handle InfoSec tasks, and execute complex queries using Elasticsearch Query DSL and ES|QL.
      37
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables LLMs to interact with OpenSearch clusters to monitor cluster health, manage indices, and perform data searches. It provides a standardized interface for real-time OpenSearch operations within MCP-compatible environments like Open WebUI.
      -
    • A
      license
      B
      quality
      F
      maintenance
      Enables interaction with OpenSearch clusters, providing tools to list indices, retrieve mappings, search using query DSL, and get shard information.
      4
      1
      Apache 2.0