Openapi Unbundler

🚀 Unbundle OpenAPI MCP Server

This project offers a Model Context Protocol (MCP) server along with tools to split OpenAPI specification files into multiple files or extract specific endpoints into new files. It enables an MCP client (such as an AI assistant) to perform programming operations on OpenAPI specifications.

🚀 Quick Start

Prerequisites

• Node.js (LTS version is recommended, e.g., v18 or v20)
• npm (comes with Node.js)

Usage

The simplest way is to use npx, which ensures you're always using the latest version without global installation:

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

Alternatively, you can install it globally (not usually recommended):

npm install -g @auto-browse/unbundle-openapi-mcp
# Then run with: unbundle-openapi-mcp

The server will start and listen for MCP requests on standard input/output (stdio).

Client Configuration

To use this server with MCP clients like VS Code, Cline, Cursor, or Claude Desktop, add its configuration to the corresponding settings file. The npx method is recommended.

VS Code / Cline / Cursor

Add the following to your user settings.json file (accessible via Ctrl+Shift+P > Preferences: Open User Settings (JSON)) or the .vscode/mcp.json file in the workspace root directory.

// In settings.json:
"mcp.servers": {
  "unbundle_openapi": { // You can choose any key name
    "command": "npx",
    "args": [
      "@auto-browse/unbundle-openapi-mcp@latest"
    ]
  }
  // ... Other servers can be added here
},

// Or in .vscode/mcp.json (omit the top-level "mcp.servers"):
{
  "unbundle_openapi": { // You can choose any key name
    "command": "npx",
    "args": [
      "@auto-browse/unbundle-openapi-mcp@latest"
    ]
  }
}

Claude Desktop

Add the following to the claudius.json file (usually located in the user directory, e.g., ~/.config/claudius/claudius.json):

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

🔧 Development

If you want to contribute or run the server from the source code:

1. Clone: Clone this repository.
2. Navigate: cd unbundle_openapi_mcp
3. Install dependencies: npm install
4. Build: npm run build (Compile TypeScript to dist/)
5. Run: npm start (Start the server using the compiled code in dist/)