OpenAPI to

This project spins up a MCP server directly from the supplied `openapi.yaml`, Every HTTP endpoint becomes an MCP tool that AnythingLLM (or any MCP-aware client) can call. LLM can control and understand your restful system.

python

2

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "rykerwang-openapi2mcpserver": {
      "command": "uv",
      "args": [
        "run",
        "openapi2mcpserver"
      ]
    }
  }
}

This MCP server automatically creates a dedicated tool for every path defined in your OpenAPI specification. It makes it easy for you to call upstream APIs through a consistent MCP interface, with built-in request shaping and flexible authentication, so you can orchestrate complex API interactions from your MCP-enabled clients.

How to use

You use this server by running it as a local process and then calling each generated MCP tool from your MCP client. Each OpenAPI path becomes an individual tool you can invoke. You can inspect the available schemas through the OpenAPI_GetSchema tool and pass parameters via path, query, headers, and request bodies. The server forwards your call to the upstream API and returns the exact status, headers, and body back to your client so you can chain actions like polling or follow-up requests.

How to install

# Prerequisites
- Ensure you have Python and uv installed or available in your environment
- Install uv for dependency management if not already present

# Install dependencies
uv sync

# Start the MCP server
uv run openapi2mcpserver

Note: You configure the server using a YAML file to define how it connects to your OpenAPI spec and how requests should be authenticated. The runtime creates an MCP tool for each API endpoint and exposes OpenAPI_GetSchema for inspecting components.schemas.

## Notes on usage patterns

- The server ingests your OpenAPI description at startup and builds a JSON Schema input for every tool. Each tool accepts inputs corresponding to its path parameters, query parameters, headers, and request bodies.

## Available tools

### OpenAPI\_GetSchema

Exposes the OpenAPI components.schemas so you can inspect data models used by the generated MCP tools.