gg-mcp-os 0.4.0

OpenSearch MCP Server с поддержкой Dashboards API и диагностикой подключения - расширенный форк с улучшенной обработкой ошибок и 9 инструментами

OpenSearch MCP Server с поддержкой Dashboards API

Форк от: opensearch-project/opensearch-mcp-server-py

Основные улучшения:

• ✅ Поддержка OpenSearch Dashboards API
• ✅ Подключение когда прямой API недоступен
• ✅ Полная совместимость с оригинальным MCP сервером

📖 Подробнее о изменениях в форке

• OpenSearch MCP Server
• Установка
• Доступные инструменты
• Быстрый старт

OpenSearch MCP Server

opensearch-mcp-server-py is a Model Context Protocol (MCP) server for OpenSearch that enables AI assistants to interact with OpenSearch clusters. It provides a standardized interface for AI models to perform operations like searching indices, retrieving mappings, and managing shards through both stdio and streaming (SSE/Streamable HTTP) protocols.

Key features:

• Seamless integration with AI assistants and LLMs through the MCP protocol
• Support for both stdio and streaming server transports (SSE and Streamable HTTP)
• Built-in tools for common OpenSearch operations
• Easy integration with Claude Desktop and LangChain
• Secure authentication using basic auth or IAM roles
• NEW: OpenSearch Dashboards API support - connect when direct OpenSearch API is not available
• NEW: Connection diagnostic tool with detailed troubleshooting and error resolution

Installing opensearch-mcp-server-py

Using uv (recommended)

# Clone the forked repository with Dashboards API support
git clone https://github.com/VladMain/opensearch-mcp-server-py.git
cd opensearch-mcp-server-py

# Install with uv
uv sync

# Run the server
uv run mcp-server-opensearch --config your_config.yml

Using pip

Opensearch-mcp-server-py can be installed from PyPI via pip:

pip install opensearch-mcp-server-py

OpenSearch Dashboards Support

This fork includes support for connecting through OpenSearch Dashboards API when direct OpenSearch access is not available. See FORT_OPENSEARCH_SETUP.md for detailed setup instructions.

Available Tools

• ConnectionDiagnosticTool: 🔧 Diagnose OpenSearch connection issues and provide detailed troubleshooting information with step-by-step resolution guidance.
• ListIndexTool: Lists all indices in OpenSearch.
• IndexMappingTool: Retrieves index mapping and setting information for an index in OpenSearch.
• SearchIndexTool: Searches an index using a query written in query domain-specific language (DSL) in OpenSearch.
• GetShardsTool: Gets information about shards in OpenSearch.
• ClusterHealthTool: Returns basic information about the health of the cluster.
• CountTool: Returns number of documents matching a query.
• ExplainTool: Returns information about why a specific document matches (or doesn't match) a query.
• MsearchTool: Allows to execute several search operations in one request.

Tool Parameters

• ConnectionDiagnosticTool

  • opensearch_cluster_name (optional): The name of the OpenSearch cluster to diagnose

• ListIndexTool

  • opensearch_url (optional): The OpenSearch cluster URL to connect to

• IndexMappingTool

  • opensearch_url (optional): The OpenSearch cluster URL to connect to
  • index (required): The name of the index to retrieve mappings for

• SearchIndexTool

  • opensearch_url (optional): The OpenSearch cluster URL to connect to
  • index (required): The name of the index to search in
  • query (required): The search query in OpenSearch Query DSL format

• GetShardsTool

  • opensearch_url (optional): The OpenSearch cluster URL to connect to
  • index (required): The name of the index to get shard information for

• ClusterHealthTool

  • opensearch_url (optional): The OpenSearch cluster URL to connect to
  • index (optional): Limit health reporting to a specific index

• CountTool

  • opensearch_url (optional): The OpenSearch cluster URL to connect to
  • index (optional): The name of the index to count documents in
  • body (optional): Query in JSON format to filter documents

• ExplainTool

  • opensearch_url (optional): The OpenSearch cluster URL to connect to
  • index (required): The name of the index to retrieve the document from
  • id (required): The document ID to explain
  • body (required): Query in JSON format to explain against the document

• MsearchTool

  • opensearch_url (optional): The OpenSearch cluster URL to connect to
  • index (optional): Default index to search in
  • body (required): Multi-search request body in NDJSON format

More tools coming soon. Click here

User Guide

For detailed usage instructions, configuration options, and examples, please see the User Guide.

Contributing

Interested in contributing? Check out our:

• Development Guide - Setup your development environment
• Contributing Guidelines - Learn how to contribute

Code of Conduct

This project has adopted the Amazon Open Source Code of Conduct. For more information see the Code of Conduct FAQ, or contact [e-mail] with any additional questions or comments.

License

This project is licensed under the Apache v2.0 License.

Copyright

Copyright 2020-2021 Amazon.com, Inc. or its affiliates. All Rights Reserved.