OpenSearch MCP Server

OpenSearch MCP Server

By seohyunjun GitHub

OpenSearch MCP Server: Open-source search cluster management component

opensearch search-cluster
Overview

what is OpenSearch MCP Server?

OpenSearch MCP Server is an open-source search cluster management component that implements the Model Context Protocol (MCP) for interacting with OpenSearch. It allows users to search documents, analyze indices, and manage clusters through a set of tools.

how to use OpenSearch MCP Server?

To use OpenSearch MCP Server, start the OpenSearch cluster using Docker Compose with the command docker-compose up -d. You can then configure it with Claude Desktop to interact with the cluster using natural language commands.

key features of OpenSearch MCP Server?

  • Index Operations: List all indices, retrieve mapping and settings for specific indices.
  • Document Operations: Search documents using OpenSearch Query DSL.
  • Cluster Operations: Get health status and statistical information about the cluster.

use cases of OpenSearch MCP Server?

  1. Managing and analyzing large datasets in an OpenSearch cluster.
  2. Performing complex searches across multiple indices.
  3. Monitoring the health and performance of the OpenSearch cluster.

FAQ from OpenSearch MCP Server?

  • What is the default username and password for OpenSearch?

The default username is opensearch and the password is test123.

  • How do I access Kibana?

You can access Kibana from http://localhost:5601 after starting the OpenSearch cluster.

  • Is OpenSearch MCP Server free to use?

Yes! OpenSearch MCP Server is open-source and free to use.

Content

OpenSearch MCP Server

Overview

This Repository Fork of elastic-mcp-server and Converted to opensearch-mcp-server MCP Server. It is a Model Context Protocol (MCP) server implementation that provides opensearch interaction. This server enables searching documents, analyzing indices, and managing cluster through a set of tools.

A Model Context Protocol (MCP) server implementation that provides opensearch interaction. This server enables searching documents, analyzing indices, and managing cluster through a set of tools.

Features

Index Operations

  • list_indices: List all indices in the Opensearch cluster.
  • get_mapping: Retrieve the mapping configuration for a specific index.
  • get_settings: Get the settings configuration for a specific index.

Document Operations

  • search_documents: Search documents in an index using Opensearch Query DSL.

Cluster Operations

  • get_cluster_health: Get health status of the cluster.
  • get_cluster_stats: Get statistical information about the cluster.

Start Opensearch Cluster

Start the Opensearch cluster using Docker Compose:

docker-compose up -d

This will start a 3-node Opensearch cluster and Kibana. Default Opensearch username opensearch, password test123.

You can access Kibana from http://localhost:5601.

Usage with Claude Desktop

Using uv with local development

Using uv requires cloning the repository locally and specifying the path to the source code. Add the following configuration to Claude Desktop's config file claude_desktop_config.json.

you need to change path/to/src/opensearch_mcp_server to the path where you cloned the repository.

{
  "mcpServers": {
    "opensearch": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/src/opensearch_mcp_server",
        "run",
        "opensearch-mcp-server"
      ],
      "env": {
        "OPENSEARCH_HOST": "https://localhost:9200",
        "OPENSEARCH_USERNAME": "opensearch",
        "OPENSEARCH_PASSWORD": "test123"
      }
    }
  }
}
  • On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • On Windows: %APPDATA%/Claude/claude_desktop_config.json

Restart Claude Desktop to load the new MCP server.

Now you can interact with your Opensearch cluster through Claude using natural language commands like:

  • "List all indices in the cluster"
  • "How old is the student Bob?"
  • "Show me the cluster health status"

License

This project is licensed under the Apache License Version 2.0 - see the LICENSE file for details.

No tools information available.
No content found.