Opensearch MCP Server

🚀 OpenSearch MCP Server

This repository is a fork of elastic-mcp-server, transformed into opensearch-mcp-server, enabling interaction with OpenSearch. It's an implementation of a Model Context Protocol (MCP) server that provides interaction with OpenSearch. The server allows users to search documents, analyze indices, and manage clusters through a set of tools.

✨ Features

Index Operations

• list_indices: List all indices in the OpenSearch cluster.
• get_mapping: Get the mapping configuration of a specific index.
• get_settings: Get the settings configuration of a specific index.

Document Operations

• search_documents: Search for documents in an index using the OpenSearch Query DSL.

Cluster Operations

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

🚀 Quick Start

Start the OpenSearch Cluster

Use Docker Compose to start the OpenSearch cluster:

docker-compose up -d

This will start an OpenSearch cluster with three nodes and Kibana. The default OpenSearch username is opensearch, and the password is test123.

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

Use Claude Desktop

Local Development with uv

To use uv, clone the repository locally and specify the source code path. Add the following configuration to the Claude Desktop configuration file claude_desktop_config.json.

Replace path/to/src/opensearch_mcp_server with the actual path of your cloned 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 the OpenSearch cluster through natural language commands, for example:

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

📄 License

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