Provides tools for OpenSearch cluster management, including index operations (listing, mapping, settings), cluster health monitoring, and document search capabilities.
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: @ragrabbit/mcp
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