mcp-registry/openapi-mcp

    ==================
      
       /// MCP ///
      /// OPE ///
        
    ==================
        
    [server:online]
    [protocol:ready]

openapi-mcp

by ckanthony

Dockerized MCP server that converts any Swagger/OpenAPI spec (local file or remote URL) into a ready-to-use Model Context Protocol (MCP) toolset so AI agents can call the underlying API without extra coding.

115
22
Open Source
GitHub

Installation

Prerequisites
1. Docker (24+) OR Go (1.21+) installed on your machine
2. An OpenAPI document (YAML/JSON) for the downstream API you want to expose through the MCP server.
Quick-start with Docker
# 1. Clone the repo $ git clone https://github.com/ckanthony/openapi-mcp.git $ cd openapi-mcp # 2. Copy or mount your OpenAPI spec into the ./specs directory $ cp path/to/your_api.yaml ./specs/ # 3. Launch the server (default port 8080) $ docker build -t openapi-mcp:latest . $ docker run -d --name mcp -p 8080:8080 -v $(pwd)/specs:/app/specs openapi-mcp:latest
Running from source (Go)
$ git clone https://github.com/ckanthony/openapi-mcp.git $ cd openapi-mcp $ go build -o mcp ./... # Provide path to your OpenAPI spec(s) $ ./mcp --spec ./specs/your_api.yaml --port 8080
Configuration Flags (typical)
--spec Path to one or more OpenAPI spec files or directories
--port HTTP port to listen on (default 8080)
--auth-token Optional shared secret passed by clients via `Authorization: Bearer <token>`
Verify
curl http://localhost:8080/healthz # => {"status":"ok"}
If you expose the server publicly, remember to set up TLS termination or run behind a secure reverse-proxy.

Documentation

License: Unknown – no license file detected in repository metadata
Updated 7/30/2025
openapi-mcp - MCP Server Registry - Augment Code