Openapi

🚀 OpenAPI からモデルコンテキストプロトコル（MCP）へのプロキシ

OpenAPI-MCP プロキシは、OpenAPI 仕様を MCP ツールに変換し、AI エージェントがカスタムラッパーを必要とせずに外部 API にアクセスできるようにします！

🚀 クイックスタート

OpenAPI からモデルコンテキストプロトコル（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: 显示请求信息而无需执行调用
    结束分支

🤝 コントリビューションガイド

• このリポジトリをフォークします。
• 新しいブランチを作成します。
• 変更内容を明確に記述したプルリクエストを送信します。

📄 ライセンス

MIT License

もしこのプロジェクトが役に立ったら、GitHub でスターをつけてください！