Back to Home
opensearch-project icon

opensearch-mcp-server-py

Verified Safe

by opensearch-project

Overview

Enables AI assistants and LLMs to interact with OpenSearch clusters by providing a standardized Model Context Protocol (MCP) interface through built-in and dynamic tools.

Installation

Run Command
uvx opensearch-mcp-server-py

Environment Variables

  • OPENSEARCH_URL
  • OPENSEARCH_USERNAME
  • OPENSEARCH_PASSWORD
  • AWS_REGION
  • AWS_IAM_ARN
  • AWS_PROFILE
  • AWS_OPENSEARCH_SERVERLESS
  • OPENSEARCH_NO_AUTH
  • OPENSEARCH_HEADER_AUTH
  • OPENSEARCH_TIMEOUT
  • OPENSEARCH_SSL_VERIFY
  • OPENSEARCH_MAX_RESPONSE_SIZE
  • OPENSEARCH_ENABLED_TOOLS
  • OPENSEARCH_DISABLED_TOOLS
  • OPENSEARCH_TOOL_CATEGORIES
  • OPENSEARCH_ENABLED_CATEGORIES
  • OPENSEARCH_DISABLED_CATEGORIES
  • OPENSEARCH_ENABLED_TOOLS_REGEX
  • OPENSEARCH_DISABLED_TOOLS_REGEX
  • OPENSEARCH_SETTINGS_ALLOW_WRITE

Security Notes

The server employs robust input validation through Pydantic models, structured authentication methods (IAM, Basic, AWS credentials, Header-based), configurable SSL verification, and active response size limiting to prevent memory exhaustion. Write operations via the GenericOpenSearchApiTool are protected by an explicit configuration setting (OPENSEARCH_SETTINGS_ALLOW_WRITE). No obvious 'eval' or hardcoded production secrets were found. The primary security consideration is user misconfiguration (e.g., enabling OPENSEARCH_NO_AUTH in production or allowing unrestricted write operations via GenericOpenSearchApiTool if not needed).

Similar Servers

Stats

Interest Score46
Security Score9
Cost ClassMedium
Avg Tokens500
Stars91
Forks59
Last Update2026-01-05

Tags

OpenSearchAILLMMCPPythonData Management