OpenAPI to MCP Server Generator

Generate MCP server tools from OpenAPI specifications. Works with mcp-server-template-ts.

Usage

Install via npm

npm install -g openapi2mcp

Or run directly with npx:

npx openapi2mcp <spec.yaml> --project-path <output-dir>

Generate an MCP Server

Start with an MCP project using our template:

git clone https://github.com/cosmonic-labs/mcp-server-template-ts.git my-mcp-server

Generate MCP tools into the server project from an OpenAPI specification:

openapi2mcp path/to/openapi.yaml --project-path my-mcp-server

CLI Options

| Option | Description | |--------|-------------| | --project-path <path> | Path to the project root directory (default: .) | | --include-tools <regex> | Regex pattern for tools to include | | --include-methods <methods> | Comma-separated HTTP methods to include (e.g., GET,POST) | | --skip-long-tool-names | Skip tools with names exceeding max length instead of erroring | | --oauth2 | Enable OAuth2 authentication | | --oauth2-auth-url <url> | OAuth2 authorization URL (required if --oauth2 is set) | | --oauth2-token-url <url> | OAuth2 token URL (required if --oauth2 is set) | | --oauth2-refresh-url <url> | OAuth2 refresh token URL |

Example with Options

openapi2mcp api-spec.yaml \
  --project-path ./my-server \
  --include-methods GET,POST \
  --include-tools "users|products" \
  --oauth2 \
  --oauth2-auth-url "https://auth.example.com/authorize" \
  --oauth2-token-url "https://auth.example.com/token"

Building from Source

Prerequisites

• Rust toolchain with wasm32-wasip2 target
• Node.js 18+
• jco

Build

npm install
npm run build

This compiles the Rust code to WASM and transpiles it to JavaScript.

Run from Source

git clone https://github.com/cosmonic-labs/mcp-server-template-ts.git tests/petstore/generated

node index.js tests/petstore/input.json --project-path tests/petstore/generated