Overview
What is OpenSearch MCP Server?
An MCP server that lets you interact with an OpenSearch cluster using natural language from any MCP client (Cursor, Cline, etc.). It provides tools for cluster health analysis, document bulk operations, index management, and search.
How to use OpenSearch MCP Server?
Install Python 3.10+ and uv. Add the server configuration to your MCP settings file, setting the environment variables OPENSEARCH_HOSTS, OPENSEARCH_USERNAME, and OPENSEARCH_PASSWORD. Run via remote repo using uvx or from a local repo using uv. For testing, you can start a 2‑node Docker cluster with the provided docker-compose.yml.
Key features of OpenSearch MCP Server?
- Get cluster health and statistics
- Bulk document operations to indices
- Create, delete, and list indices
- Retrieve index mappings and info
- Search with query DSL
- Natural language queries via MCP clients
Use cases of OpenSearch MCP Server?
- Monitor cluster health via conversational commands
- Bulk index large datasets into OpenSearch
- Automate index creation and deletion tasks
- Search documents using complex queries
- Retrieve index mappings for schema inspection
FAQ from OpenSearch MCP Server
What are the prerequisites?
Python 3.10 or higher and uv must be installed.
How do I configure authentication?
Set the environment variables OPENSEARCH_USERNAME and OPENSEARCH_PASSWORD in your MCP settings file.
Can I connect to multiple OpenSearch hosts?
Yes. Separate host addresses with commas in the OPENSEARCH_HOSTS environment variable.
How can I start a local OpenSearch cluster for testing?
Run export OPENSEARCH_INITIAL_ADMIN_PASSWORD=your_password then docker-compose up -d. Default credentials: admin / your_opensearch_cluster_password.
What license does this project use?
Apache v2.0 License.
