Openapi MCP Generator

🚀 OpenAPI から MCP サーバー生成ツール

OpenAPI 仕様を Model Context Protocol (MCP) 互換サーバーに変換するコマンドラインツールです。このツールは、OpenAPI 3.0 標準をサポートし、効率的に MCP サーバーを生成できます。

✨ 主な機能

• OpenAPI サポート：OpenAPI 3.0 標準をサポートし、MCP サーバーを解析して生成できます。
• 代理動作：リクエスト転送機能を実装し、複数の認証方式をサポートします。
• 認証サポート：API Key、Bearer Token、Basic Auth、OAuth2 などの複数の認証方式をサポートします。
• Zod 検証：Zod を使用してデータを検証し、入出力の合法性を保証します。
• 複数の転送モード：標準入出力（stdio）、SSE ベースの Web サーバー、ストリーミング HTTP 転送をサポートします。

📦 インストール

npm install -g @your-package-name

💻 使用例

基本的な使用法

1. プロジェクトを初期化します：

mcp-server init your-project-name

2. 指示に従って OpenAPI 設定ファイルを記入します。
3. サーバーを起動します：

cd your-project-name
npm start

高度な使用法

転送モードの選択

• stdio モード：ローカル開発や LLM ツールへの統合に適しています。
• Web サーバー（SSE）：SSE ベースの双方向メッセージ通信を提供し、複数の接続とブラウザクライアントをサポートします。
• ストリーミング HTTP モード：状態ful JSON - RPC を実装し、完全な HTTP ステータスコードとヘッダー情報をサポートします。

認証設定

環境変数を使用して認証情報を設定します：

📚 ドキュメント

プロジェクト構造

your-project-name/
├── package.json          # プロジェクトの依存関係とスクリプト設定
├── openapi.yaml         # OpenAPI 仕様ファイル
├── config.js            # サーバー設定
└── src/                 # ビジネスロジックコードのディレクトリ

転送モードの比較

サーバーの起動

cd your-project-name
npm install

# 標準入出力モード
npm start

# Web サーバーモード
npm run start:web

# ストリーミング HTTP モード
npm run start:http

Web モードのテストクライアント

1. サーバーを起動した後、ブラウザを開き http://localhost:<port> にアクセスします。
2. 生成されたテストクライアントを使用して MCP サーバーとやり取りします。

システム要件

• Node.js バージョン v20 以上。

⚠️ 重要提示

このプロジェクトは現在開発段階であり、不安定性や潜在的な問題がある可能性があります。使用する前にドキュメントをよく読み、十分なテストを行ってください。