OpenSearch MCP Server
@seohyunjun
OpenSearch MCP Server: Open-source search cluster management component
Overview
What is OpenSearch MCP Server?
OpenSearch MCP Server is a Model Context Protocol (MCP) server implementation that provides OpenSearch interaction, enabling searching documents, analyzing indices, and managing a cluster through a set of tools. It is a fork of the Elasticsearch MCP Server converted to work with OpenSearch.
How to use OpenSearch MCP Server?
Clone the repository, then configure Claude Desktop’s config file (claude_desktop_config.json) with the uv command pointing to the local source directory. Set environment variables OPENSEARCH_HOST, OPENSEARCH_USERNAME, OPENSEARCH_PASSWORD, and DASHBOARDS_HOST. Restart Claude Desktop to load the server.
Key features of OpenSearch MCP Server
- List all indices in the OpenSearch cluster.
- Retrieve mapping configuration for a specific index.
- Get settings configuration for a specific index.
- Search documents using OpenSearch Query DSL.
- Get health status of the cluster.
- Get statistical information about the cluster.
Use cases of OpenSearch MCP Server
- Query documents in an OpenSearch index via natural language.
- Monitor cluster health and statistics through an AI assistant.
- Explore index mappings and settings without the Dev Tools console.
- Automate index management tasks using conversational commands.
FAQ from OpenSearch MCP Server
How does OpenSearch MCP Server authenticate to the OpenSearch cluster?
Authentication is handled via environment variables OPENSEARCH_USERNAME and OPENSEARCH_PASSWORD. The server uses these credentials to connect to the host specified in OPENSEARCH_HOST.
What are the runtime dependencies?
The server requires uv (Python package manager) and the source code cloned from the repository. No additional system-wide installations are described beyond a Python environment.
Can I run the server without a local Docker cluster?
The README shows starting an OpenSearch cluster with Docker Compose, but the server itself only requires a reachable OpenSearch host. You can point it at any existing cluster by configuring the environment variables.
Does the server support OpenSearch Dashboards?
Yes, it includes a DASHBOARDS_HOST environment variable to connect to Dashboards (Kibana equivalent) for UI access.
What transport and security options are available?
The server uses MCP (stdio-based) transport. Security is provided by the username/password authentication sent over HTTPS (the example uses https://localhost:9200).
