OpenAPI MCP Server

Name: OpenAPI MCP Server
Author: MCP-Mirror

@MCP-Mirror

Repository

About OpenAPI MCP Server

Mirror of

#openapi #mcp #api-server

Basic information

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

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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).