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/ 中启动服务器）