MCP-сервер Кибана

Спецификация API

Этот проект основан на официальной документации API Elastic Kibana и использует спецификацию OpenAPI YAML из Elastic Stack 8.x (ES8) для динамического извлечения и управления всеми конечными точками API Kibana. Для получения последних подробностей см. документацию API Kibana .

Реализация сервера Kibana MCP, которая позволяет любому MCP-совместимому клиенту (например, Claude Desktop) получать доступ к вашему экземпляру Kibana с помощью естественного языка или программных запросов.

Этот проект поддерживается сообществом и не является официальным продуктом Elastic или MCP.

Функции

• Подключайтесь к локальным или удаленным экземплярам Kibana

• Безопасная аутентификация (имя пользователя/пароль)

• Поддержка SSL/TLS и пользовательских сертификатов CA

• Предоставляет конечные точки API Kibana как инструменты и ресурсы

• Поиск, просмотр и выполнение API Kibana из клиентов MCP

• Типобезопасный, расширяемый и легко интегрируемый

Структура каталога

Ресурсы

Примеры:

• kibana-api://paths?search=saved_objects

• kibana-api://path/GET/%2Fapi%2Fstatus

Инструменты

Подсказки

Конфигурация

Настройте сервер через переменные среды:

Использование

Запустить сервер

Пример конфигурации клиента MCP

Добавьте в файл конфигурации Claude Desktop (путь MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json ):

Примеры запросов

• «Каков статус моего сервера Kibana?»

• «Перечислите все доступные конечные точки API Kibana».

• «Показать сведения о конечной точке POST /api/saved_objects/_find».

• «Выполнить пользовательский запрос API для /api/status».

• «Получить список всех панелей мониторинга в Kibana».

• «Запрос конечных точек API, связанных с событиями конечных точек».

• «Перечислите все конечные точки API, связанные с делом».

• «Создайте новое дело в Кибане».

• «Создайте новую панель инструментов в Kibana».

Два режима подсказок в Claude Desktop

При использовании этого сервера с Claude Desktop поддерживаются два различных режима интерактивного взаимодействия:

1. Режим подсказок на основе инструментов

• Как это работает: Claude Desktop может напрямую вызывать серверные инструменты (такие как get_status , execute_api , search_kibana_api_paths и т. д.), чтобы отвечать на ваши вопросы или выполнять действия.

• Лучше всего подходит для: пользователей, которым нужен разговорный, управляемый опыт. Сервер будет автоматически искать, выполнять и объяснять API Kibana.

• Пример: «Показать все конечные точки API Kibana, связанные с сохраненными объектами».

• Совет по тестированию: выберите приглашение kibana-tool-expert в Claude Desktop для интеграционного тестирования, затем начните его использовать.

2. Режим подсказок на основе ресурсов

• Как это работает: Claude Desktop взаимодействует с сервером через URI ресурсов (например, kibana-api://paths или kibana-api://path/GET/%2Fapi%2Fstatus ), а сервер возвращает структурированные данные, которые Claude может проанализировать.

• Лучше всего подходит для: опытных пользователей, клиентов MCP, которые поддерживают только доступ к ресурсам, или сценариев программирования, требующих необработанных метаданных API.

• Пример: «Получить ресурс kibana-api://paths?search=dashboard»

Примечание: Две конечные точки в resources ( kibana-api://paths и kibana-api://path/{method}/{encoded_path} ) имеют соответствующие базовые инструменты ( list_all_kibana_api_paths , get_kibana_api_detail ). Такая конструкция обеспечивает совместимость с клиентами MCP, которые не могут интеллектуально выбирать несколько ресурсов, что упрощает взаимодействие таких инструментов, как Claude Desktop, с Kibana.

Совет: Большинству пользователей рекомендуется использовать режим инструментов для более естественного и эффективного использования; режим ресурсов обеспечивает максимальную гибкость для расширенных вариантов использования и совместимости.

Разработка

Установить зависимости:

Сборка сервера:

Автоматическая перестройка в режиме разработки:

Отладка

Поскольку сервер MCP взаимодействует через stdio, отладка может быть неудобной. Рекомендуется использовать MCP Inspector:

После запуска Inspector предоставит доступный через браузер URL-адрес инструмента отладки.

Сообщество

Этот проект поддерживается сообществом. Вклады и отзывы приветствуются! Пожалуйста, будьте уважительны и инклюзивны во всех коммуникациях и следуйте Кодексу поведения сообщества Elastic .

Лицензия

Этот проект лицензирован по Apache License 2.0. Подробности смотрите в файле LICENSE .

Поиск неисправностей

• Проверьте правильность конфигурации MCP

• Убедитесь, что адрес Kibana доступен

• Убедитесь, что учетные данные аутентификации имеют достаточные разрешения.

• При использовании пользовательского центра сертификации убедитесь, что путь к сертификату правильный и читаемый.

• При использовании NODE_TLS_REJECT_UNAUTHORIZED=0 помните о рисках безопасности

• Проверьте сообщения об ошибках, выводимые в терминале.