Openapi

OpenAPI - MCPは、OpenAPI仕様を動的にMCPツールに変換するプロキシサーバーで、AIエージェントがカスタムラッパーなしで外部APIにアクセスできるようにします。

開発者ツール人工知能チャットボット #APIプロキシ #ツール変換 #AI統合 #OpenAPI解析 .Python

スコア : 2.5ポイント

ダウンロード数 : 39

更新時間 : 2025-04-28

OpenAPIからMCPへのプロキシサーバーとは？

OpenAPIからMCPへのプロキシサーバーは、OpenAPI仕様ファイルを解析し、API操作を標準化されたMCPツール、リソース、およびヒントに変換するブリッジツールです。これにより、AIエージェントはカスタムラッパーを作成することなく、外部APIを簡単に呼び出すことができます。

OpenAPIからMCPへのプロキシサーバーをどのように使用するか？

このサーバーをインストールし、OpenAPI仕様ファイルに接続するように設定するだけで使用を開始できます。その後、AIエージェントはローカルツールを呼び出すようにリモートAPIを呼び出すことができます。

適用シーン

外部APIを迅速に統合する必要があるAIプロジェクト、特に複数の異なるAPIを頻繁に呼び出す必要があるサービスに適しています。

主要機能

複数の伝送方式をサポート標準入出力（stdio）のサポートを最適化し、人気のあるLLMコーディネーターと直接連携できます。

OpenAPIの自動解析OpenAPI仕様ファイルを解析し、すべての利用可能な操作を呼び出し可能なMCPツールとして登録します。

リソースの自動登録OpenAPIコンポーネントモードを定義されたURIを持つリソースオブジェクトに自動変換します。

コンテキストヒントの生成API操作に基づいてコンテキストヒントを生成し、LLMがAPIの使用方法をよりよく理解できるように支援します。

OAuth2サポート機械認証を処理し、クライアント資格情報フローをサポートします。

JSON - RPC 2.0互換性JSON - RPC 2.0のリクエスト/レスポンス構造に完全に準拠しています。

拡張ツールメタデータ詳細なパラメータ情報とレスポンスモードを含みます。

利点と制限

利点

API統合プロセスを簡素化し、カスタムラッパーを作成する必要がありません。

複数の伝送プロトコルをサポートし、既存のシステムとの統合が容易です。

強力なパラメータ解析機能で、データ型の正確性を保証します。

動的にコンテキストヒントを生成し、LLMの理解能力を向上させます。

制限

有効なOpenAPI仕様ファイルに依存しています。

非常に複雑なAPIには追加の設定が必要な場合があります。

一部の高度な機能には特定の環境設定が必要な場合があります。

使い方

サーバーのインストール

リポジトリをクローンし、依存関係をインストールします。

Llmコーディネーターの設定

Llmコーディネーターにサーバー設定を追加します。

サーバーの起動

サーバースクリプトを実行してリクエストの監視を開始します。

使用例

ペットショップ内のすべてのペットを照会OpenAPIからMCPへのプロキシサーバーを使用して、ペットショップ内のすべてのペットを照会します。

新しい注文を作成プロキシサーバーを使用して新しい注文を作成します。

よくある質問

OpenAPIからMCPへのプロキシサーバーをどのようにインストールするか？

OAuth2認証をサポートしているか？

JSON - RPC 2.0プロトコルをサポートしているか？

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

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

OpenAPI-MCP

🚀 クイックスタート

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: 显示请求信息而无需执行调用
    结束分支