OpenAPI MCP Server

@MCP-Mirror

About OpenAPI MCP Server

Mirror of

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "openapi": {
      "command": "npx",
      "args": [
        "-y",
        "@ivotoby/openapi-mcp-server"
      ],
      "env": {
        "API_BASE_URL": "https://api.example.com",
        "OPENAPI_SPEC_PATH": "https://api.example.com/openapi.json",
        "API_HEADERS": "Authorization:Bearer token123,X-API-Key:your-api-key"
      }
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is OpenAPI MCP Server?

OpenAPI MCP Server is a Model Context Protocol (MCP) server that exposes OpenAPI endpoints as MCP resources. It allows Large Language Models to discover and interact with REST APIs defined by OpenAPI specifications through the MCP protocol.

How to use OpenAPI MCP Server?

Configure it in Claude Desktop by editing claude_desktop_config.json and adding the server entry with npx -y @ivotoby/openapi-mcp-server. Required environment variables are API_BASE_URL, OPENAPI_SPEC_PATH, and optionally API_HEADERS. You can also pass these as command line arguments to npm run inspect.

Key features of OpenAPI MCP Server

Exposes OpenAPI endpoints as MCP resources for LLMs
Supports custom API authentication headers
Configurable via environment variables or command line
Includes development tools (build, lint, typecheck)
Auto‑reload with inspect‑watch for rapid development
Debug logs output to stderr for troubleshooting

Use cases of OpenAPI MCP Server

Let Claude Desktop dynamically discover and call REST APIs
Build custom MCP servers wrapping existing OpenAPI specs
Test and validate API interactions using the MCP Inspector
Enable LLMs to perform authenticated operations on remote APIs

FAQ from OpenAPI MCP Server

What dependencies does OpenAPI MCP Server require?

Node.js and npx are needed. The server is run via npx without cloning the repository.

Where does the OpenAPI specification live?

It is loaded from a URL or file path provided in the OPENAPI_SPEC_PATH environment variable.

How do I authenticate API requests?

Authentication headers are passed as comma‑separated key:value pairs in the API_HEADERS environment variable (e.g., Authorization:Bearer token123).

What transport protocol does OpenAPI MCP Server use?

It uses the MCP (Model Context Protocol) to expose resources and tools to LLM clients.

Are there any known limits?

—

Frequently asked questions

What dependencies does OpenAPI MCP Server require?

Node.js and npx are needed. The server is run via `npx` without cloning the repository.

Where does the OpenAPI specification live?

It is loaded from a URL or file path provided in the `OPENAPI_SPEC_PATH` environment variable.

How do I authenticate API requests?

Authentication headers are passed as comma‑separated key:value pairs in the `API_HEADERS` environment variable (e.g., `Authorization:Bearer token123`).

What transport protocol does OpenAPI MCP Server use?

It uses the MCP (Model Context Protocol) to expose resources and tools to LLM clients.

Comments

Basic information

More Other MCP servers

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K