Openapi Unbundler

🚀 解包 OpenAPI MCP 服務器

該項目提供了一個模型上下文協議（MCP）服務器，配備了相關工具，可將 OpenAPI 規範文件拆分為多個文件，或者將特定端點提取到新文件中。它支持 MCP 客戶端（如 AI 助手）對 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 請求。

💻 使用示例

基礎用法

上述安裝指南中的命令即為基礎使用方式，啟動服務器監聽 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/ 中啟動服務器）