OpenAPI MCP Generator

v3.3.0Developer Toolsstable

A tool that converts OpenAPI specifications to MCP server

openapimcpmodel-context-protocolgeneratorllm
Share:
590
Stars
0
Downloads
0
Weekly
0/5

What is OpenAPI MCP Generator?

OpenAPI MCP Generator is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to tool that converts openapi specifications to mcp server

A tool that converts OpenAPI specifications to MCP server

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A tool that converts OpenAPI specifications to MCP server

Use Cases

Convert OpenAPI specifications into MCP servers automatically.
Expose REST APIs to AI agents through generated MCP interfaces.
harsha-iiiv

Maintainer

LicenseMIT
Languagetypescript
Versionv3.3.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y openapi-mcp-generator

Manual Installation

npx -y openapi-mcp-generator

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use OpenAPI MCP Generator

OpenAPI MCP Generator automatically converts OpenAPI specifications into fully functional MCP servers. This tool bridges REST APIs and AI agents, allowing Claude and other LLMs to interact with any service through auto-generated MCP interfaces with type-safe tool definitions.

Prerequisites

  • Node.js 18+ installed
  • An MCP client such as Claude Desktop or Cursor
  • An OpenAPI 3.0 specification file (YAML or JSON)
1

Install OpenAPI MCP Generator

Install the generator package via npm.

npx -y openapi-mcp-generator
2

Prepare your OpenAPI specification

Have your OpenAPI 3.0 spec file ready (local or remote URL).

3

Generate the MCP server

Run the generator with your OpenAPI spec to create the MCP server. See the repository README for exact command syntax.

openapi-mcp-generator --spec=/path/to/openapi.json
4

Add generated server to client config

Register the generated server in claude_desktop_config.json.

{
  "mcpServers": {
    "my-api-mcp": {
      "command": "node",
      "args": ["./generated-server/index.js"]
    }
  }
}
5

Restart and test

Restart your MCP client and ask Claude to call a tool from your API.

OpenAPI MCP Generator Examples

Client configuration example

Configuration for a generated OpenAPI MCP server in claude_desktop_config.json.

{
  "mcpServers": {
    "my-api-mcp": {
      "command": "node",
      "args": ["./generated-server/index.js"]
    }
  }
}

Prompts to try

Request operations from your API through Claude.

Call the /users endpoint to list all users
Create a new resource using the POST /items endpoint
Fetch data from my REST API using the auto-generated tools

Troubleshooting OpenAPI MCP Generator

Generator fails to parse OpenAPI spec

Validate your OpenAPI 3.0 spec using online validators or the Swagger Editor. Ensure the spec is valid YAML or JSON and conforms to OpenAPI 3.0 schema.

Generated server has missing or incorrect tools

Review your OpenAPI specification for completeness. Check the repository README for known limitations and ensure your spec includes proper schemas and descriptions.

Frequently Asked Questions about OpenAPI MCP Generator

What is OpenAPI MCP Generator?

OpenAPI MCP Generator is a Model Context Protocol (MCP) server that tool that converts openapi specifications to mcp server It connects AI assistants to external tools and data sources through a standardized interface.

How do I install OpenAPI MCP Generator?

Install via npm with the command: npx -y openapi-mcp-generator. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with OpenAPI MCP Generator?

OpenAPI MCP Generator works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is OpenAPI MCP Generator free to use?

Yes, OpenAPI MCP Generator is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "openapi-mcp-generator": { "command": "npx", "args": ["-y", "openapi-mcp-generator"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use OpenAPI MCP Generator?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides