trackmcp
Back to directory
showjason

opensearch-mcp-server

View on GitHub

OpenSearch MCP Server

2 stars PythonOthers Updated Sep 21, 2025

Documentation

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

Installation

bash
# 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:

code
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:

bash
uv run opensearch-mcp-server --port=

Integrate with Cursor

code
{
  "mcpServers": {
    "opensearch": {
      "url": "http://:>/sse"
    }
  }
}

Usage with Claude Desktop APP

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

Development

bash
# Install dependencies
uv pip install -e .

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

License

MIT

Frequently asked questions

What is opensearch-mcp-server?

opensearch-mcp-server is OpenSearch MCP Server

How do I install opensearch-mcp-server?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is opensearch-mcp-server open source?

Yes — it is hosted on GitHub at https://github.com/showjason/opensearch-mcp-server and has 2 stars.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP