OAS-MCP

What is OAS-MCP?

OAS-MCP is a Go application that automatically generates a Model Context Protocol (MCP) server and tools from an OpenAPI specification (YAML or JSON). It is designed for developers who want to expose REST API endpoints as MCP tools.

How to use OAS-MCP?

Clone the repository, install dependencies with go mod download, then run go run cmd/main.go -path=./api/openapi.yaml -output=./pkg/client to generate client code and MCP server. Alternatively, use go generate ./....

Key features of OAS-MCP

• Auto-generates Go client code from OpenAPI specs
• Builds MCP servers using generated client code
• Provides each API endpoint as a separate MCP tool
• Uses SSE (Server-Sent Events) for real-time communication

Use cases of OAS-MCP

• Rapidly bridging existing REST APIs to MCP-based AI assistants
• Exposing OpenAPI endpoints as tools for AI agents
• Automating MCP server creation from API specifications

FAQ from OAS-MCP

What are the prerequisites?

Go version 1.24 or higher is required.

What transport mechanism does OAS-MCP use?

It uses Server-Sent Events (SSE) for real-time communication.

What are the main dependencies?

It relies on ogen-go/ogen for OpenAPI Go code generation, mark3labs/mcp-go for MCP server implementation, and dave/jennifer for code generation.