OpenSearch MCP Server
MCP server for opensearch mcp server py
What is OpenSearch MCP Server?
OpenSearch MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for opensearch mcp server py
MCP server for opensearch mcp server py
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server for opensearch mcp server py
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx opensearch-mcp-server-pyConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use OpenSearch MCP Server
OpenSearch MCP Server (Python) is the official MCP server from the OpenSearch project that lets AI agents query and manage OpenSearch clusters through natural language. It exposes tools for searching indices with full Query DSL, retrieving mappings, checking cluster health, analyzing shard allocation, running multi-search operations, and optionally maintaining persistent agent memory across sessions using OpenSearch as a vector store. DevOps engineers, data engineers, and AI developers use it to interact with OpenSearch clusters without writing raw HTTP requests or Query DSL by hand.
Prerequisites
- Python 3.10+ with pip or uvx
- A running OpenSearch cluster (local, AWS, or managed)
- OPENSEARCH_URL pointing to your cluster endpoint
- Credentials: OPENSEARCH_USERNAME/OPENSEARCH_PASSWORD for basic auth, or AWS IAM credentials for AWS OpenSearch Service
- An MCP-compatible client such as Claude Desktop or Cursor
Install the package
Install from PyPI using pip. The package includes all required OpenSearch client dependencies.
pip install opensearch-mcp-server-pyConfigure connection environment variables
Set the cluster URL and authentication method. For basic auth use username/password; for AWS OpenSearch Service use the IAM variables; for unauthenticated local clusters set OPENSEARCH_NO_AUTH=true.
# Basic auth
export OPENSEARCH_URL=https://localhost:9200
export OPENSEARCH_USERNAME=admin
export OPENSEARCH_PASSWORD=admin
# AWS OpenSearch Service
export OPENSEARCH_URL=https://your-domain.us-east-1.es.amazonaws.com
export AWS_REGION=us-east-1
export AWS_PROFILE=your-profileAdd to Claude Desktop config
Edit the Claude Desktop config file to register the server. Using uvx allows zero-install execution directly from PyPI.
{
"mcpServers": {
"opensearch": {
"command": "uvx",
"args": ["opensearch-mcp-server-py"],
"env": {
"OPENSEARCH_URL": "https://localhost:9200",
"OPENSEARCH_USERNAME": "admin",
"OPENSEARCH_PASSWORD": "admin",
"OPENSEARCH_SSL_VERIFY": "false"
}
}
}
}Enable optional tool categories
By default only core search tools are enabled. Enable additional categories with environment variables. For example, enable agentic memory (requires OpenSearch 3.3.0+) or search relevance experimentation tools.
# Enable agent memory
export MEMORY_TOOLS_ENABLED=true
export OPENSEARCH_MEMORY_CONTAINER_ID=my-memory-container
# Disable specific categories
export OPENSEARCH_DISABLED_CATEGORIES=cluster_managementVerify the connection
Ask your MCP client to list all indices. If the ClusterHealthTool returns green or yellow status the server is connected and operational.
OpenSearch MCP Server Examples
Client configuration
Full JSON config for Claude Desktop connecting to a local OpenSearch cluster with SSL verification disabled for development.
{
"mcpServers": {
"opensearch": {
"command": "uvx",
"args": ["opensearch-mcp-server-py"],
"env": {
"OPENSEARCH_URL": "https://localhost:9200",
"OPENSEARCH_USERNAME": "admin",
"OPENSEARCH_PASSWORD": "admin",
"OPENSEARCH_SSL_VERIFY": "false",
"OPENSEARCH_TIMEOUT": "30"
}
}
}
}Prompts to try
These prompts exercise the core OpenSearch MCP tools from index discovery to query execution and cluster diagnostics.
- "List all indices in my OpenSearch cluster with their document counts and sizes"
- "Search the logs-2025 index for error events in the last 24 hours"
- "Show me the mapping for the products index"
- "What is the current cluster health status and are there any unassigned shards?"
- "Run a multi-search query comparing results from the orders and returns indices"
- "Analyze the hot threads on each node to find performance bottlenecks"Troubleshooting OpenSearch MCP Server
SSL certificate verification errors when connecting to a local OpenSearch cluster
Set OPENSEARCH_SSL_VERIFY=false in your environment or MCP config env block. For production clusters use a valid certificate and leave SSL verification enabled.
AWS OpenSearch authentication fails with 403 Forbidden
Ensure your AWS credentials are valid and that the IAM role or user has the 'es:ESHttpGet', 'es:ESHttpPost', and 'es:ESHttpPut' permissions on the OpenSearch domain. Set AWS_REGION to match your domain's region exactly.
Agentic memory tools are not available in the tools list
Memory tools require OpenSearch 3.3.0+ and must be explicitly enabled. Set MEMORY_TOOLS_ENABLED=true and restart the server. Also verify that your cluster version meets the minimum requirement with the ClusterHealthTool.
Frequently Asked Questions about OpenSearch MCP Server
What is OpenSearch MCP Server?
OpenSearch MCP Server is a Model Context Protocol (MCP) server that mcp server for opensearch mcp server py It connects AI assistants to external tools and data sources through a standardized interface.
How do I install OpenSearch MCP Server?
Follow the installation instructions on the OpenSearch MCP Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with OpenSearch MCP Server?
OpenSearch MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is OpenSearch MCP Server free to use?
Yes, OpenSearch MCP Server is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
OpenSearch MCP Server Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to OpenSearch MCP Server? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up OpenSearch MCP Server in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use OpenSearch MCP Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.