OpenAPI to Model Context Protocol (MCP)

OpenAPI для моделирования контекстного протокола (MCP)

Прокси-сервер OpenAPI-MCP преобразует спецификации OpenAPI в инструменты MCP, позволяя агентам ИИ получать доступ к внешним API без специальных оболочек!

Устранение разрыва между агентами ИИ и внешними API

Прокси-сервер OpenAPI to Model Context Protocol (MCP) устраняет разрыв между агентами ИИ и внешними API, динамически преобразуя спецификации OpenAPI в стандартизированные инструменты , ресурсы и подсказки MCP. Это упрощает интеграцию, устраняя необходимость в пользовательских оболочках API.

• Репозиторий: https://github.com/gujord/OpenAPI-MCP

Если вы считаете это полезным, пожалуйста, поставьте ему ⭐ на GitHub!

Основные характеристики

• FastMCP Transport: оптимизирован для stdio , работает «из коробки» с популярными оркестраторами LLM.
• Интеграция OpenAPI: анализирует и регистрирует операции OpenAPI как вызываемые инструменты.
• Регистрация ресурсов: автоматически преобразует схемы компонентов OpenAPI в объекты ресурсов с определенными URI.
• Генерация подсказок: создает контекстные подсказки на основе операций API, помогающие магистрам права использовать API.
• Поддержка OAuth2: обеспечивает аутентификацию компьютера с помощью потока учетных данных клиента.
• Поддержка JSON-RPC 2.0: полностью совместимая структура запроса/ответа.
• Автоматические метаданные: извлекает названия инструментов, сводки и схемы из спецификации OpenAPI.
• Очищенные имена инструментов: обеспечивают совместимость с ограничениями имен MCP.
• Гибкий анализ параметров: поддерживает строки запросов (с начальным «?») и несколько вариаций JSON (включая ключи с точками и числовыми значениями).
• Улучшенная обработка параметров: автоматически преобразует параметры в правильные типы данных.
• Расширенные метаданные инструмента: включают подробную информацию о параметрах и схемы ответов.

Быстрый старт

Установка

Конфигурация оркестратора LLM

Для Claude Desktop , Cursor и Windsurf используйте приведенный ниже фрагмент и соответствующим образом измените пути:

Примените эту конфигурацию к следующим файлам:

• Курсор: ~/.cursor/mcp.json
• Виндсерфинг: ~/.codeium/windsurf/mcp_config.json
• Рабочий стол Клода: ~/Library/Application Support/Claude/claude_desktop_config.json

Замените full_path_to_openapi_mcp на фактический путь установки.

Конфигурация среды

Как это работает

1. Анализирует спецификацию OpenAPI: загружает спецификацию OpenAPI с помощью httpx и PyYAML при необходимости.
2. Регистрирует операции: извлекает операции API и генерирует MCP-совместимые инструменты с надлежащими схемами ввода и ответа.
3. Регистрация ресурсов: автоматически преобразует схемы компонентов OpenAPI в объекты ресурсов с назначенными URI (например, /resource/{name} ).
4. Генерация подсказок: создает контекстные подсказки на основе операций API, чтобы помочь магистрам уровня магистра понять использование API.
5. Аутентификация: поддерживает аутентификацию OAuth2 через поток учетных данных клиента.
6. Обработка параметров: преобразует параметры в требуемые типы данных и поддерживает гибкие форматы строк запросов и JSON.
7. Соответствие JSON-RPC 2.0: обеспечивает стандартные протоколы связи для взаимодействия инструментов.

Ресурсы и подсказки

Помимо инструментов, прокси-сервер теперь автоматически регистрирует:

• Ресурсы: полученные из схем компонентов OpenAPI, объекты ресурсов регистрируются с определенными URI (например, /resource/{name} ) для структурированной обработки данных.
• Подсказки: Контекстные подсказки генерируются на основе операций API, чтобы предоставить LLM-специалистам руководство по использованию, улучшая их понимание доступных конечных точек.

Эти расширенные метаданные улучшают интеграцию, предоставляя полный контекст API.

Внося вклад

• Сделайте форк этого репозитория.
• Создайте новую ветку.
• Отправьте запрос на извлечение с четким описанием ваших изменений.

Лицензия

Лицензия Массачусетского технологического института

Если вы считаете это полезным, пожалуйста, поставьте ему ⭐ на GitHub!