OpenSearch MCP Server

by seohyunjun
Apache 2.0
7
  • Apple

Integrations

  • Enables running an OpenSearch cluster through Docker Compose for development and testing purposes, with a preconfigured 3-node cluster setup.

  • Offers access to Kibana as part of the OpenSearch integration, allowing users to visualize and explore data stored in OpenSearch through the Kibana interface.

  • Provides tools for searching documents, analyzing indices, and managing OpenSearch clusters, including operations to list indices, retrieve mappings and settings, search documents using Query DSL, and monitor cluster health and statistics.

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.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A Model Context Protocol server implementation that enables natural language interactions with OpenSearch clusters, allowing users to search documents, analyze indices, and manage clusters through simple conversational commands.

  1. Overview
    1. Features
      1. Index Operations
      2. Document Operations
      3. Cluster Operations
    2. Start Opensearch Cluster
      1. Usage with Claude Desktop
        1. Using uv with local development
      2. License

        Related MCP Servers

        • A
          security
          A
          license
          A
          quality
          Facilitates interaction with Elasticsearch clusters by allowing users to perform index operations, document searches, and cluster management via a Model Context Protocol server and natural language commands.
          Last updated -
          6
          127
          Python
          Apache 2.0
          • Apple
        • -
          security
          F
          license
          -
          quality
          A Model Context Protocol server that enables LLMs to interact with Elasticsearch clusters, allowing them to manage indices and execute search queries using natural language.
          Last updated -
          1
          JavaScript
        • -
          security
          F
          license
          -
          quality
          A Model Context Protocol server that enables querying and analyzing Wazuh security logs stored in OpenSearch, with features for searching alerts, getting detailed information, generating statistics, and visualizing trends.
          Last updated -
          JavaScript
        • -
          security
          A
          license
          -
          quality
          A server that enables natural language interactions with Couchbase databases through the Model Context Protocol, allowing users to perform SQL++ queries on Couchbase Capella clusters using conversational commands.
          Last updated -
          JavaScript
          MIT License

        View all related MCP servers

        ID: lddmyhpjgk