OpenAPI Mcp Server

What is OpenAPI Mcp Server?

OpenAPI Mcp Server exposes any REST API as an MCP (Model Context Protocol) server based on its OpenAPI schema. It automatically generates MCP tools from OpenAPI operations with comprehensive support for OpenAPI 3.0+ schemas in JSON and YAML formats.

How to use OpenAPI Mcp Server?

Install and build the project with npm install && npm build. Run it using npm start -- --schema <path-to-schema> [options]. You can also add the server to Claude Desktop by editing its configuration file and providing the full path to the built index.js and your schema file.

Key features of OpenAPI Mcp Server

• Complete OpenAPI 3.0+ support with JSON and YAML parsing
• Advanced schema processing: $ref resolution and composition (oneOf/anyOf/allOf)
• Automatic MCP tool generation with rich descriptions and validation
• Multiple content types: JSON, XML, form data, multipart uploads
• Authentication via HTTP Basic Auth or custom headers
• TypeScript implementation with 90%+ test coverage

Use cases of OpenAPI Mcp Server

• Instantly turn any REST API into MCP tools for AI assistants
• Securely integrate authenticated APIs with Claude Desktop
• Quickly expose OpenAPI-defined microservices to AI agents
• Combine multiple REST APIs under a unified MCP server configuration

FAQ from OpenAPI Mcp Server

What OpenAPI versions does it support?

It supports OpenAPI 3.0+ schemas in JSON and YAML formats.

How do I add authentication?

You can use HTTP Basic Authentication via --username and --password options, or add custom headers (e.g., Bearer tokens) using the --headers option. Both can be combined.

What are the runtime requirements?

It requires Node.js and npm. You need to install dependencies and build the project before running.

Where does the data live?

The server does not store data locally; it fetches data from the configured REST API endpoints and returns responses directly.

What transport and authentication methods are supported?

The server uses the standard MCP stdio transport. Authentication supports HTTP Basic Auth and arbitrary custom headers passed via command line.