OpenAPI MCP Server

What is OpenAPI MCP Server?

A Model Context Protocol server that reads an OpenAPI specification file (YAML) and exposes each API operation as a tool for Claude AI to use. It automatically parses the spec, generates tools for every operation, and makes live API calls when Claude invokes them.

How to use OpenAPI MCP Server?

Clone the repository, install dependencies (npm install), optionally set OPENAPI_FILE environment variable to point to your OpenAPI YAML file (default: ./openapi.yaml), then run npm run init to integrate with Claude Desktop or npm start to run the server manually.

Key features of OpenAPI MCP Server

• Automatically parses OpenAPI YAML files
• Generates MCP tools for each API operation
• Handles path parameters, query parameters, and request bodies
• Makes live API calls when Claude uses the tools
• Easy integration with Claude Desktop

Use cases of OpenAPI MCP Server

• Let Claude AI interact with any REST API described by an OpenAPI specification
• Automate API calls through natural language commands
• Prototype and test API endpoints without writing custom code
• Enable non‑technical users to explore APIs via conversational interface

FAQ from OpenAPI MCP Server

What runtime is required to run OpenAPI MCP Server?

Node.js and npm are required. The server runs on any system that supports Node.js.

Where should I place my OpenAPI specification file?

Place your OpenAPI YAML file in the project directory or specify its path via the OPENAPI_FILE environment variable (default ./openapi.yaml).

Does OpenAPI MCP Server work with MCP clients other than Claude Desktop?

The README explicitly mentions integration with Claude Desktop; no other MCP clients are addressed.

Can I enable debug logging?

Yes. Set the DEBUG environment variable to true to enable debug logging (default is false).

What format is supported for the OpenAPI spec?

The server reads OpenAPI YAML files. It does not mention JSON or other formats.