Openapi Unbundler

🚀 解包 OpenAPI MCP サーバー

このプロジェクトは、モデルコンテキストプロトコル（MCP）サーバーを提供します。このサーバーには、OpenAPI 仕様ファイルを複数のファイルに分割したり、特定のエンドポイントを新しいファイルに抽出したりするツールが付属しています。MCP クライアント（AI アシスタントなど）が OpenAPI 仕様をプログラムで操作できるようになります。

🚀 クイックスタート

✨ 主な機能

• OpenAPI 仕様ファイルを複数のファイルに分割する。
• 特定のエンドポイントを新しいファイルに抽出する。
• MCP クライアントが OpenAPI 仕様をプログラムで操作できるようにする。

📦 インストール

前提条件

• Node.js（LTS バージョンを推奨、例：v18 または v20）
• npm（Node.js と一緒に提供されます）

インストール方法

npx を使用するのが最も簡単な方法で、グローバルにインストールすることなく常に最新バージョンを使用できます。

npx @auto-browse/unbundle-openapi-mcp@latest

または、グローバルにインストールすることもできます（通常は推奨されません）。

npm install -g @auto-browse/unbundle-openapi-mcp
# 次に以下のコマンドで実行します：unbundle-openapi-mcp

サーバーは起動し、標準入出力（stdio）上で MCP リクエストを待機します。

💻 使用例

基本的な使用法

npx @auto-browse/unbundle-openapi-mcp@latest

高度な使用法

# グローバルにインストールした場合の実行方法
unbundle-openapi-mcp

📚 ドキュメント

クライアント設定

このサーバーを VS Code、Cline、Cursor または Claude Desktop などの MCP クライアントと一緒に使用するには、対応する設定ファイルにその設定を追加します。npx 方法の使用をお勧めします。

VS Code / Cline / Cursor

以下の内容をユーザーの settings.json ファイル（Ctrl+Shift+P > Preferences: Open User Settings (JSON) でアクセスできます）またはワークスペースのルートディレクトリの .vscode/mcp.json ファイルに追加します。

// settings.json の場合：
"mcp.servers": {
  "unbundle_openapi": { // 任意のキー名を選択できます
    "command": "npx",
    "args": [
      "@auto-browse/unbundle-openapi-mcp@latest"
    ]
  }
  // ... 他のサーバーをここに追加できます
},

// または .vscode/mcp.json の場合（トップレベルの "mcp.servers" を省略）：
{
  "unbundle_openapi": { // 任意のキー名を選択できます
    "command": "npx",
    "args": [
      "@auto-browse/unbundle-openapi-mcp@latest"
    ]
  }
}

Claude Desktop

以下の内容を claudius.json ファイル（通常はユーザーディレクトリにあります。例：~/.config/claudius/claudius.json）に追加します。

{
  "servers": {
    "unbundle_openapi": {
      "command": "npx",
      "args": ["@auto-browse/unbundle-openapi-mcp@latest"]
    }
  }
}

🔧 技術詳細

開発

このサーバーに貢献したり、ソースコードから実行したりする場合は、以下の手順に従ってください。

1. クローン：このリポジトリをクローンします。
2. 移動：cd unbundle_openapi_mcp
3. 依存関係のインストール：npm install
4. ビルド：npm run build（TypeScript を dist/ にコンパイルします）
5. 実行：npm start（dist/ のコンパイル済みコードでサーバーを起動します）