Back to Home
opensearch-project icon

opensearch-mcp-server-py

Verified Safe

by opensearch-project

Overview

Enables AI assistants to interact with OpenSearch clusters, providing a standardized interface for search, mapping, and shard management.

Installation

Run Command
uvx opensearch-mcp-server-py --transport stream

Environment Variables

  • OPENSEARCH_URL
  • OPENSEARCH_USERNAME
  • OPENSEARCH_PASSWORD
  • AWS_IAM_ARN
  • AWS_REGION
  • AWS_ACCESS_KEY_ID
  • AWS_SECRET_ACCESS_KEY
  • AWS_SESSION_TOKEN
  • AWS_PROFILE
  • AWS_OPENSEARCH_SERVERLESS
  • OPENSEARCH_NO_AUTH
  • OPENSEARCH_HEADER_AUTH
  • OPENSEARCH_TIMEOUT
  • OPENSEARCH_SSL_VERIFY
  • 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 `GenericOpenSearchApiTool` allows calling any OpenSearch API endpoint, which is powerful but inherently risky if an AI agent is unconstrained or compromised, potentially leading to data manipulation, deletion, or exposure. While `OPENSEARCH_SETTINGS_ALLOW_WRITE` offers some protection against write operations, it's configurable. Disabling SSL verification (`OPENSEARCH_SSL_VERIFY=false`) is possible and can introduce man-in-the-middle risks if not carefully managed. AWS authentication methods (`boto3`) and basic auth are standard.

Similar Servers

Stats

Interest Score52
Security Score7
Cost ClassMedium
Avg Tokens1500
Stars78
Forks51
Last Update2025-12-03

Tags

AIOpenSearchLLMMCPPython