mcp-OpenSearch

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

# 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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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 Servers

metoro-mcp-serverofficial
metoro-io
-
security
A
license
-
quality
Query and interact with kubernetes environments monitored by Metoro. Look at APM, metrics, traces, profiling information with LLMs.
Last updated -
37
Go
MIT License
Elasticsearch MCP Server
cr7258
A
security
A
license
A
quality
Facilitates interaction with Elasticsearch clusters by allowing users to perform index operations, document searches, and cluster management via a Model Context Protocol server and natural language commands.
Last updated -
6
127
Python
Apache 2.0
@ragrabbit/mcp
madarco
-
security
A
license
-
quality
Access any documentation indexed by RagRabbit Open Source AI site search
Last updated -
3
33
TypeScript
MIT License
Elasticsearch MCP Server
da1y
-
security
F
license
-
quality
A Model Context Protocol server that enables LLMs to interact with Elasticsearch clusters, allowing them to manage indices and execute search queries using natural language.
Last updated -
1
JavaScript

View all related MCP servers