🤖 OpenAPI MCP Server

Name: 🤖 OpenAPI MCP Server
Author: JacerOmri

@JacerOmri

Repository Homepage

About 🤖 OpenAPI MCP Server

CLI tool to create an MCP server exposing services from an OpenAPI specification

#cli #rest #server #proxy #mcp #openapi

Basic information

Config

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

{
  "mcpServers": {
    "openapi-mcp-proxy": {
      "command": "npx",
      "args": [
        "openapi-mcp-proxy",
        "--spec",
        "./path/to/openapi.yml",
        "--target",
        "http://your-api.com",
        "--port",
        "3000"
      ]
    }
  }
}

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?

A command-line tool that transforms any OpenAPI service into a Model Context Protocol (MCP) server, enabling seamless integration with AI agents and tools that support the MCP specification. It automatically generates an MCP server from an OpenAPI spec and proxies requests between MCP clients and the original REST API.

How to use OpenAPI MCP Server?

Install globally via npm install -g openapi-mcp-proxy, then run with npx openapi-mcp-proxy --spec <path> --target <url> --port <number>. The --spec option is required; target and port default to http://localhost:8080 and 3000 respectively. The server exposes endpoints on the given port under the /mcp path.

Key features of OpenAPI MCP Server

Transforms any OpenAPI spec into an MCP server
Proxies requests between MCP and REST conventions
No modifications required to the original service
Supports JSON and YAML OpenAPI specs
Configurable target URL, port, and spec path

Use cases of OpenAPI MCP Server

Make existing REST APIs accessible to AI agents via MCP
Rapidly prototype AI integrations with any OpenAPI‑compliant service
Use with VS Code’s agent mode for natural language API interactions
Test and inspect MCP endpoints using the official MCP Inspector

FAQ from OpenAPI MCP Server

What is Model Context Protocol (MCP)?

MCP is a standardized protocol for AI agents to interact with external tools and services, providing a consistent way for AI models to discover and use capabilities through a unified interface.

What is OpenAPI?

OpenAPI (formerly Swagger) is a specification for machine-readable interface files that describe, produce, consume, and visualize RESTful web services without needing source code access.

How do I install and run OpenAPI MCP Server?

Install globally: npm install -g openapi-mcp-proxy. Then run npx openapi-mcp-proxy --spec ./openapi.yml --target http://your-api.com --port 3000. The --spec argument is required; --target and --port are optional.

How can I test the MCP server?

Use the MCP Inspector via npx @modelcontextprotocol/inspector and navigate to http://localhost:3000/mcp. Alternatively, add the server URL to VS Code’s agent mode (Cmd/Ctrl+Shift+P, “MCP: add Server”) and interact through Copilot.

What are the required and optional parameters?

--spec (or env OMP_OPENAPI_SPEC_FILE) is required. --target (env OMP_TARGET_BASE_URL, default http://localhost:8080), --port (env PORT, default 3000), --version, and --help are optional.

Comments

More Other MCP servers

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

🚀 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