OpenAPI to MCP Server

What is OpenAPI to MCP Server?

A command-line tool that converts OpenAPI specifications (JSON or YAML) into MCP (Model Context Protocol) server configurations. It generates tool definitions, parameter mappings, and response templates, making it easy to expose REST APIs as MCP tools.

How to use OpenAPI to MCP Server?

Install via go install github.com/higress-group/openapi-to-mcpserver/cmd/openapi-to-mcp@latest. Then run openapi-to-mcp --input <openapi-file> --output <mcp-config.yaml> with optional flags such as --server-name, --tool-prefix, --format, --validate, and --template to customize the output.

Key features of OpenAPI to MCP Server

• Converts OpenAPI paths to MCP tools with correct parameter positions
• Supports JSON and YAML input and output formats
• Generates response templates with field descriptions for LLM readability
• Handles path, query, header, cookie, and body parameters automatically
• Optionally validates OpenAPI specifications before conversion
• Supports template-based patching for custom headers, auth, and output schemas

Use cases of OpenAPI to MCP Server

• Quickly generate MCP tool definitions from any OpenAPI‑described API
• Integrate REST APIs with Higress REST‑to‑MCP gateway configuration
• Automate creation of consistent MCP server configurations for multiple APIs
• Add global authentication headers or default output schemas via template patching