Unbundle OpenAPI MCP Server

by auto-browse

API/Management & Tools OpenAPI API Redocly Specification

This server provides a Model Context Protocol (MCP) interface for manipulating OpenAPI specifications. It allows splitting large OpenAPI files into smaller ones or extracting specific endpoints into a new file.

View on GitHub

Last updated: N/A

What is Unbundle OpenAPI MCP Server?

The Unbundle OpenAPI MCP Server is a tool that allows programmatic manipulation of OpenAPI specifications through a Model Context Protocol (MCP) interface. It provides functionalities to split large OpenAPI files into smaller, more manageable parts or to extract specific endpoints into a new OpenAPI file.

How to use Unbundle OpenAPI MCP Server?

The server can be used via npx @auto-browse/unbundle-openapi-mcp@latest or by installing it globally with npm install -g @auto-browse/unbundle-openapi-mcp. It listens for MCP requests on standard input/output (stdio). Client applications like VS Code, Cline, Cursor, or Claude Desktop can be configured to use the server by adding its configuration to their respective settings files, specifying the command and arguments to execute the server.

Key features of Unbundle OpenAPI MCP Server

Splits OpenAPI specification files into multiple smaller files.
Extracts specific endpoints from an OpenAPI file into a new file.
Provides an MCP interface for programmatic manipulation.
Uses redocly split and redocly bundle internally.
Supports configuration with VS Code, Cline, Cursor, and Claude Desktop.

Use cases of Unbundle OpenAPI MCP Server

Breaking down large OpenAPI specifications for easier management.
Creating smaller, focused OpenAPI files for specific API subsets.
Integrating OpenAPI manipulation into AI assistant workflows.
Automating the process of generating OpenAPI definitions for specific use cases.

FAQ from Unbundle OpenAPI MCP Server

What is MCP?

MCP stands for Model Context Protocol, a protocol that allows clients (like AI assistants) to interact with servers to perform specific tasks.

What is Redocly?

Redocly is a tool for working with OpenAPI specifications. This server uses Redocly's CLI to split and bundle OpenAPI files.

Do I need to install Redocly CLI separately?

No, the server uses npx @redocly/cli@latest internally, so you don't need to install it separately. However, an internet connection might be required for npx to fetch @redocly/cli if it's not cached.

How do I configure the server with VS Code?

Add the server's configuration to your User settings.json or to a .vscode/mcp.json file in your workspace root. The configuration should include the command npx and the argument @auto-browse/unbundle-openapi-mcp@latest.

What happens if an endpoint specified in `endpointsToKeep` doesn't exist?

Paths not found in the original spec will be ignored during the extraction process.