Openapi

🚀 OpenAPI 到模型上下文協議（MCP）代理

OpenAPI-MCP 代理能夠將 OpenAPI 規範轉換為 MCP 工具，讓 AI 代理無需自定義包裝器就能訪問外部 API！

🚀 快速開始

OpenAPI 到 Model Context Protocol (MCP) 代理服務器通過動態轉換 OpenAPI 規範為標準化的 MCP 工具、資源和提示語，成功橋接了 AI 代理與外部 API 之間的差距。

✨ 主要特性

• 工具註冊：將 OpenAPI 定義轉換為 MCP 可用的工具，支持複雜的數據結構處理。
• 自動資源註冊：從 OpenAPI 組件模式生成資源對象，並通過定義明確的 URI（例如 /resource/{name}）進行註冊。
• 上下文提示語：基於 API 操作生成提示語，指導 LLM 使用相關端點，提升交互性。

序列圖
    參與者 LLM 作為 Claude/GPT
    參與者 MCP 作為 OpenAPI-MCP 代理
    參與者 API 作為外部 API

    在 LLM 和 API 上標註：通信流程

    LLM->>MCP: 1. 初始化 (initialize)
    MCP-->>LLM: 元數據、工具、資源和提示語

    LLM->>MCP: 2. 請求工具列表 (tools_list)
    MCP-->>LLM: 工具的詳細列表，包括資源和提示語

    LLM->>MCP: 3. 調用工具 (tools_call)

    條件分支：帶有 OAuth2
        MCP->>API: 請求 OAuth2 訪問令牌
        API-->>MCP: 接收訪問令牌
    結束分支

    MCP->>API: 4. 執行 API 調用，格式正確
    API-->>MCP: 5. API 響應（JSON 格式）

    條件分支：類型轉換
        MCP->>MCP: 6. 將參數轉換為正確的數據類型
    結束分支

    MCP-->>LLM: 7. 格式化的 API 響應

    條件分支：乾燥運行模式
        LLM->>MCP: 調用 dry_run=true
        MCP-->>LLM: 顯示請求信息而無需執行調用
    結束分支

🤝 貢獻指南

• fork 此倉庫。
• 創建一個新的分支。
• 提交一個清晰描述更改的 pull request。

📄 許可證

MIT License

💡 使用建議

如果這個項目對你有幫助，請在 GitHub 上給它點個星星！