OpenSearch·opensearch-project
OpenSearch MCP — подключение и инструкция
OpenSearch MCP предоставляет агенту инструменты работы с индексами и поиска в кластере OpenSearch.
Что умеет этот сервер
OpenSearch MCP предоставляет агенту инструменты работы с индексами и поиска в кластере OpenSearch.
Официальный Python-сервер поддерживает zero-config запуск: адрес и параметры соединения могут передаваться в вызовах.
Прочитай 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.
- 01
Подготовь окружение
Python/uv и доступный OpenSearch. Подготовь endpoint и разрешённый способ аутентификации по User Guide.
- 02
Установи и настрой
Добавь uvx opensearch-mcp-server-py в клиент. Выбери статические env-настройки или предусмотренные dynamic connection parameters. Проверь подключение к одному тестовому кластеру и права на нужный индекс.
- 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-серверов Нейролюба.