MCP Server Opensearch

🚀 MCP-Server-OpenSearch: An OpenSearch MCP Server

MCP-Server-OpenSearch provides an example of creating an MCP server for OpenSearch, enabling seamless integration between LLM applications and the OpenSearch search and analysis engine.

Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. Whether you're building an AI-driven IDE, enhancing a chat interface, or creating custom AI workflows, MCP provides a standardized way to connect LLMs with the context they need.

This repository demonstrates an example of how to create an MCP server for OpenSearch, a distributed search and analysis engine.

🛑 Current Obstacle - Unable to Install OpenSearch Async Client

Open Search Async Client Documentation

pip install opensearch-py[async]
zsh: no matches found: opensearch-py[async]

📋 Overview

A basic MCP server for saving and retrieving memories in the OpenSearch engine. It serves as a semantic memory layer on top of the OpenSearch database.

🧩 Components

Tools

1. search-openSearch
   • Store a memory in the OpenSearch database.
   • Input:
     • query (json): A prepared JSON query message.
   • Return: A confirmation message.

📦 Installation

Install via Smithery

To automatically install mcp-server-opensearch for Claude Desktop using Smithery:

npx -y @smithery/cli install @ibrooksSDX/mcp-server-opensearch --client claude

Use uv (Recommended)

When using uv, you can directly run mcp-server-opensearch without special installation.

uv run mcp-server-opensearch \
  --opensearch-url "http://localhost:9200" \
  --index-name "my_index" \

Or

uv run fastmcp run demo.py:main

🧪 Testing - Local OpenSearch Client

uv run python src/mcp-server-opensearch/test_opensearch.py

🧪 Testing - Connection between MCP Server and OpenSearch Client

cd src/mcp-server-opensearch
uv run fastmcp dev demo.py

🚀 Integration with Claude Desktop

To use this server with the Claude Desktop application, add the following configuration to the claude_desktop_config.json file in the "mcpServers" section:

{
  "opensearch": {
    "command": "uvx",
    "args": [
      "mcp-server-opensearch",
      "--opensearch-url",
      "http://localhost:9200",
      "--opensearch-api-key",
      "your_api_key", // Replace with your API key
      "--index-name",
      "your_index_name" // Replace with the index name you want to use
    ]
  }, 
  "Demo": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp"
      ]
    }
}