{"id":18631,"library":"openapi-mcp-server","title":"OpenAPI MCP Server","description":"An MCP (Model Context Protocol) server (v2.1.0) that enables AI assistants like Claude and Cursor to search and explore OpenAPI specifications through oapis.org. It follows a three-step process: identifying the needed OpenAPI identifier, fetching a plain-language summary, and examining specific endpoints. Unlike v1, v2 focuses purely on exploration and code generation without executing API calls, since authentication is not yet standardized in MCP. Supports JSON and YAML. Node.js >=18 required, ESM-only, published on npm.","status":"active","version":"2.1.0","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","openapi","mcp","server","proxy"],"install":[{"cmd":"npm install openapi-mcp-server","lang":"bash","label":"npm"},{"cmd":"yarn add openapi-mcp-server","lang":"bash","label":"yarn"},{"cmd":"pnpm add openapi-mcp-server","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Provides the MCP server framework for tool/request handling","package":"@modelcontextprotocol/sdk","optional":false}],"imports":[{"note":"ESM-only since v2; CJS require() will throw. Default import.","wrong":"const OpenAPIMCPServer = require('openapi-mcp-server')","symbol":"OpenAPIMCPServer","correct":"import OpenAPIMCPServer from 'openapi-mcp-server'"},{"note":"Named export for fetching a plain-language summary of an OpenAPI spec.","symbol":"getOpenAPISummary","correct":"import { getOpenAPISummary } from 'openapi-mcp-server'"},{"symbol":"getEndpointDetails","correct":"import { getEndpointDetails } from 'openapi-mcp-server'"}],"quickstart":{"code":"import OpenAPIMCPServer from 'openapi-mcp-server';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\n\nconst server = new OpenAPIMCPServer();\nconst transport = new StdioServerTransport();\nawait server.connect(transport);\nconsole.error('OpenAPI MCP Server running on stdio');","lang":"typescript","description":"Creates and starts an OpenAPI MCP server using the stdio transport, enabling AI assistants to search and explore OpenAPI specs."},"warnings":[{"fix":"If you relied on v1's ability to call endpoints directly, do not upgrade. Stay on v1.x (e.g., `npm install openapi-mcp-server@1.2.0`).","message":"V2 is a complete rewrite: no tool execution, no authentication handling. V1 APIs are removed.","severity":"breaking","affected_versions":">=2.0.0 <3.0.0"},{"fix":"Migrate to v2 if you only need exploration; otherwise consider alternative MCP servers that support API execution.","message":"V1.x is deprecated and no longer maintained. All development effort is on v2.","severity":"deprecated","affected_versions":"<2.0.0"},{"fix":"Use `import` statements. Ensure `\"type\": \"module\"` in your package.json.","message":"Package is ESM-only from v2. Using `require()` throws a runtime error.","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Update Node.js to 18 or newer (e.g., using nvm).","message":"Node.js 18+ is required. Older versions fail with SyntaxError or missing APIs.","severity":"gotcha","affected_versions":">=2.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Change to `import OpenAPIMCPServer from 'openapi-mcp-server'`. If you cannot use ESM, stay on v1.x.","cause":"Package is ESM-only since v2, but you used require().","error":"Error [ERR_REQUIRE_ESM]: require() of ES Module /path/to/node_modules/openapi-mcp-server/index.js not supported."},{"fix":"Use `import OpenAPIMCPServer from 'openapi-mcp-server'` (no curly braces). The default export is the class.","cause":"Default import was used incorrectly or the module exports differently.","error":"TypeError: OpenAPIMCPServer is not a constructor"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}