Skip to main content
Glama

MCP OpenAPI Proxy

by electrocucaracha
GitHub
Python
4
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP OpenAPI

License GitHub Super-Linter Ruby Style Guide Code style: black

visitors Scc Code Badge Scc COCOMO Badge

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

sequenceDiagram actor user as User actor agent as Agent participant ingress as Ingress participant mcp_proxy as MCP Proxy participant openapi_server as OpenAPI Server participant db as Database user->>ingress: Request for OpenAPI resource ingress->>openapi_server: Forward request openapi_server->>db: Query database db-->>openapi_server: Database response openapi_server-->> user: OpenAPI Server response Note over user,db: LLM interaction user->>agent: Send a prompt agent->>ingress: Request for MCP tool ingress->>mcp_proxy: Forward request mcp_proxy->>openapi_server: Forward request openapi_server->>db: Query database db-->>openapi_server: Database response openapi_server-->>mcp_proxy: OpenAPI Server response mcp_proxy-->>agent: MCP server response agent-->>user: Prompt response

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:

Open in GitHub Codespaces

Option 2: Local Dev Container (Visual Studio Code)

  1. Install Visual Studio Code.

  2. Install the Dev Containers extension.

  3. Ensure you have a container runtime installed and running:

  4. Open this repository in Visual Studio Code.

  5. 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
F
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.

  1. Key Features
    1. Use Cases
      1. Workflow
        1. Environment variables
          1. How to setup a development environment
            1. Option 1: GitHub Codespaces
            2. Option 2: Local Dev Container (Visual Studio Code)
          2. Validation
            1. List available tools
            2. Call a tool

          Related MCP Servers

          • Emcee

            mattt
            -
            security
            A
            license
            -
            quality
            Generate an MCP server for any OpenAPI documented endpoint.
            Last updated -
            295
            MIT License
            • Apple
            • Linux

          • 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
            • Apple

          • 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

          Appeared in Searches

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/electrocucaracha/mcp-openapi-proxy'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server