Openapi To Mcp
☕ 🏠 🍎 🪟 🐧 - MCP server that automatically converts any OpenAPI/Swagger specification into a set of usable MCP tools. Unlike manual tool definition, this approach auto-generates tools directly from the Swagger spec, ensuring consistency, reducing maintenance effort, and preventing mismatches between the tools and the actual API.
Quick Install
{
"mcpServers": {
"bbonnin-openapi-to-mcp": {
"command": "npx",
"args": [
"-y",
"bbonnin-openapi-to-mcp"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
OpenApi MCP Server
OpenApiMCPServer is an MCP server that automatically converts any OpenAPI/Swagger specification into a set of usable MCP tools.
It analyzes all API endpoints, generates structured tool definitions, and routes tool calls to the underlying REST API. This allows AI agents to interact with any OpenAPI-based service instantly, without manual tool coding.
Modules
There are several modules:
-
openapi-mcp-server: the application that is a MCP server providing the tools defined in an OpenAPI definition (provided as a local file or an HTTP endpoint)- This server dynamically loads the Swagger content and provides the functions of the API through the MCP protocol, so they can be used in a generative AI architecture without recoding anything
- At startup:
- At runtime:
-
openapi-mcp-example: a simple example divided in two parts- In
apipackage : a fake infrastructure API for managing virtual machines. The API will be invoked by the OpenAPI MCP Server - In
assistantpackage : an assistant with a simple chat that will use the infrastructure API through the MCP server accessing the API
- In
Run
MCP Server
To start the MCP Server
java -jar $PATH_TO_JAR/openapi-mcp-server.jar --openapi.location=<swagger file or URL>
Example
-
Start the example parts, in your IDE, launch:
- The InfrastructureApiServer class
- The InfraAssistantApp class by providing the LLM URL and the MCP server
-
The MCP server, in the IDE:
- The OpenApiMcpServer class by providing the OpenAPI location and the Spring profile dev if needed
