OpenSearch·opensearch-project

OpenSearch MCP — подключение и инструкция

OpenSearch MCP предоставляет агенту инструменты работы с индексами и поиска в кластере OpenSearch.

Рабочие сервисыЛокальноAPI-ключ

Что умеет этот сервер

01

OpenSearch MCP предоставляет агенту инструменты работы с индексами и поиска в кластере OpenSearch.

02

Официальный Python-сервер поддерживает zero-config запуск: адрес и параметры соединения могут передаваться в вызовах.

03

Прочитай mapping индекса, затем выполни небольшой search с явным size и фильтром.

Задача для знакомства

Через OpenSearch MCP покажи mapping тестового индекса и несколько результатов ограниченного поиска. Индексы и документы не изменяй.

Уточнить результат

Сверь cluster endpoint, index/alias и mapping. Пустая выборка может быть результатом фильтра или прав, а не отсутствия данных; проверь запрос и timezone.

Как подключить

Выберите подходящий способ

Подключить OpenSearch MCP

Добавь uvx opensearch-mcp-server-py в клиент. Выбери статические env-настройки или предусмотренные dynamic connection parameters. Проверь подключение к одному тестовому кластеру и права на нужный индекс.

Что понадобится

  • Python/uv и доступный OpenSearch. Подготовь endpoint и разрешённый способ аутентификации по User Guide.
  1. 01

    Подготовь окружение

    Python/uv и доступный OpenSearch. Подготовь endpoint и разрешённый способ аутентификации по User Guide.

  2. 02

    Установи и настрой

    Добавь uvx opensearch-mcp-server-py в клиент. Выбери статические env-настройки или предусмотренные dynamic connection parameters. Проверь подключение к одному тестовому кластеру и права на нужный индекс.

  3. 03

    Открой новую сессию

    Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.

Пример MCP-конфигурации на основе README

{
  "mcpServers": {
    "opensearch": {
      "command": "uvx",
      "args": [
        "opensearch-mcp-server-py"
      ]
    }
  }
}

Первый запрос — пример для чата агента

Через OpenSearch MCP покажи mapping тестового индекса и несколько результатов ограниченного поиска. Индексы и документы не изменяй.

Как проверить

Сверь cluster endpoint, index/alias и mapping. Пустая выборка может быть результатом фильтра или прав, а не отсутствия данных; проверь запрос и timezone.

Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.

README и установка автора

Что умеет OpenSearch

OpenSearch MCP предоставляет агенту инструменты работы с индексами и поиска в кластере OpenSearch.

Официальный Python-сервер поддерживает zero-config запуск: адрес и параметры соединения могут передаваться в вызовах. Это не значит, что кластер доступен без авторизации или что токены следует писать в общий чат.

Что подготовить перед подключением

Python/uv и доступный OpenSearch. Подготовь endpoint и разрешённый способ аутентификации по User Guide.

Как установить и подключить

Добавь uvx opensearch-mcp-server-py в клиент. Выбери статические env-настройки или предусмотренные dynamic connection parameters. Проверь подключение к одному тестовому кластеру и права на нужный индекс.

Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.

Как пользоваться: первый сценарий

Прочитай mapping индекса, затем выполни небольшой search с явным size и фильтром. Интерпретируй поля по схеме и проверь временной диапазон.

Как проверить результат и решить проблемы

Сверь cluster endpoint, index/alias и mapping. Пустая выборка может быть результатом фильтра или прав, а не отсутствия данных; проверь запрос и timezone.

Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.

Ограничения

Тяжёлые поисковые запросы нагружают кластер. Возможности определяются ролью, настройками и версией OpenSearch; MCP не заменяет управление доступом.

Исходники и документация

Репозиторий: opensearch-project/opensearch-mcp-server-py. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.

Другие подключения — в каталоге MCP-серверов Нейролюба.

Вопросы о OpenSearch

OpenSearch MCP предоставляет агенту инструменты работы с индексами и поиска в кластере OpenSearch.
Вернуться в библиотеку