Advertise
MCP.so
Sign In

OpenAPI to MCP Server

@gujord

RepositoryHomepage

Basic information

Category

Other

License

MIT

Transports

stdio

Author

gujord

About OpenAPI to MCP Server

The OpenAPI-MCP proxy translates OpenAPI specs into MCP tools, enabling AI agents to access external APIs without custom wrappers!

#python#ai#mcp#openapi#gemini#openai#agents#claude#fastapi#llm#mcp-s

OpenAPI to MCP Server config

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

{
  "mcpServers": {
    "petstore3": {
      "command": "full_path_to_openapi_mcp/venv/bin/python",
      "args": [
        "full_path_to_openapi_mcp/src/server.py"
      ],
      "env": {
        "SERVER_NAME": "petstore3",
        "OPENAPI_URL": "https://petstore3.swagger.io/api/v3/openapi.json"
      },
      "transport": "stdio"
    }
  }
}

OpenAPI to MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is OpenAPI to Model Context Protocol (MCP)?

OpenAPI to Model Context Protocol (MCP) is a proxy server that dynamically translates OpenAPI specifications into standardized MCP tools, resources, and prompts. It bridges the gap between AI agents and external APIs, eliminating the need for custom API wrappers. Built with FastMCP, it supports stdio, SSE, and streamable HTTP transports.

How to use OpenAPI to Model Context Protocol (MCP)?

Install using uvx openapi-mcp-proxy (recommended), pip install openapi-mcp-proxy, or from source. Set environment variables such as OPENAPI_URL and SERVER_NAME, then run the server. It can be configured for Claude Desktop, Cursor, or Windsurf using provided JSON configurations for HTTP or stdio transport.

Key features of OpenAPI to Model Context Protocol (MCP)

  • Dynamically converts OpenAPI operations into callable MCP tools.
  • Supports OAuth2 Client Credentials and username/password authentication.
  • Offers stdio, SSE, and streamable HTTP transports.
  • Automatically registers OpenAPI component schemas as MCP resources.
  • Generates contextual prompts to guide LLMs in API usage.
  • Provides robust error handling and structured logging.

Use cases of OpenAPI to Model Context Protocol (MCP)

  • Expose a public weather API (e.g., MET Norway) as MCP tools for Claude Desktop.
  • Run multiple OpenAPI services (e.g., weather and petstore) simultaneously for multi-tool AI agents.
  • Secure internal APIs behind authentication (OAuth2 or username/password) and make them accessible to LLM orchestrators.
  • Enable local OpenAPI specs with custom headers for development or private APIs.
  • Deploy as a Docker service for production-ready MCP integration.

Frequently asked questions

1

How do I install OpenAPI to Model Context Protocol (MCP)?

Use `uvx openapi-mcp-proxy` for immediate execution, or install with `pip install openapi-mcp-proxy` and then run `openapi-mcp`. You can also clone the GitHub repository and install from source.

2

What authentication methods are supported?

The server supports OAuth2 Client Credentials flow and username/password authentication. You can also provide custom headers via the `MCP_AUTH_HEADERS` environment variable.

3

Which transport protocols are available?

It supports stdio, MCP HTTP transport (streamable HTTP), and legacy SSE (deprecated). The recommended transport for Claude Desktop is HTTP transport.

4

Can I run multiple API servers at once?

Yes. Start each server with a different `SERVER_NAME` and port, then configure Claude Desktop to point to each endpoint (e.g., `http://127.0.0.1:8001/sse` and `http://127.0.0.1:8002/sse`).

5

How do I configure Claude Desktop to use this server?

Copy the provided `claude_desktop_config.json` to `~/Library/Application Support/Claude/claude_desktop_config.json`. For HTTP transport, set `MCP_HTTP_ENABLED=true` and `MCP_HTTP_PORT=8001`, then start the server.

Comments

More Other MCP servers

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Advertise