MCP OpenAPI Proxy

MCP OpenAPI

This project aims to accelerate the adoption of the MCP protocol by simplifying server generation through automated tooling. It parses an OpenAPI specification and dynamically generates the corresponding MCP server components.

Key Features

Parses OpenAPI specifications
Dynamically generates MCP-compatible server code and tools
Designed to streamline integration and deployment

Use Cases

One common use case is deploying this application as a sidecar alongside existing services. This enables seamless MCP support without requiring manual server implementation.

By automating the translation from OpenAPI to MCP, this tool reduces the overhead of manual server development and promotes faster adoption of the MCP protocol within modern service architectures.

Workflow

Environment variables

Name	Default	Description
OPENAPI_SPEC_URL		URL of the Open API specification.
TRANSPORT	streamable-http	Transport type to use for communication with the MCP server.
HOST	127.0.0.1	Hostname or IP address to bind the server to.
PORT	8000	Port number to listen on.

How to setup a development environment

This project includes Dev Container support, making it easy to get started with a fully configured development environment. This ensures consistency across development setups and allows contributors to begin working without manual environment configuration.

Option 1: GitHub Codespaces

You can launch a cloud-based development environment instantly:

Option 2: Local Dev Container (Visual Studio Code)

Install Visual Studio Code.
Install the Dev Containers extension.
Ensure you have a container runtime installed and running:
- Docker Desktop (Windows/macOS)
- Docker Engine or Podman (Linux)
Open this repository in Visual Studio Code.
When prompted, reopen the project in a Dev Container.

Validation

A helper script is provided to validate the MCP server. It uses the MCP Python SDK to connect, list tools, and execute them.

List available tools

./tests/client.py -m http://localhost:8000/mcp

Example output:

{
  "properties": {
    "url": {
      "title": "Url",
      "type": "string"
    }
  },
  "required": ["url"],
  "title": "fetch_websiteArguments",
  "type": "object"
}

Call a tool

./tests/client.py -m http://localhost:8000/mcp -a call-tool -t fetch -i url=https://electrocucaracha.com/acerca/

Example output (truncated):

<!DOCTYPE html>
<html lang="es">
  <head>
    <meta charset="UTF-8" />
    ...
  </head>
</html>

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A tool that accelerates MCP protocol adoption by automatically generating MCP-compatible server components from OpenAPI specifications, enabling seamless integration with existing services as a sidecar.

Related MCP Servers

Emcee
mattt
-
security
A
license
-
quality
Generate an MCP server for any OpenAPI documented endpoint.
Last updated -
295
MIT License
OpenAPI to MCP Server
TykTechnologies
A
security
A
license
A
quality
A tool that creates MCP (Model Context Protocol) servers from OpenAPI/Swagger specifications, enabling AI assistants to interact with your APIs.
Last updated -
3
5
24
MIT License
Specbridge
TBosak
A
security
A
license
A
quality
An MCP server that automatically converts OpenAPI specifications into MCP tools by scanning a folder for spec files, requiring no configuration files or separate servers.
Last updated -
2
5
MIT License
OpenAPI to MCP Server
jeweis
-
security
F
license
-
quality
A service that converts OpenAPI specifications into MCP tools, enabling AI assistants to interact with your API endpoints through natural language.
Last updated -

View all related MCP servers