MCP Link - Convert Any OpenAPI V3 API to MCP Server

🧩 Architecture

🤔 Why MCP Link?

There is a notable gap in the current AI Agent ecosystem:

• Most MCP Servers are simple wrappers around Web APIs
• Functionality interfaces may not be complete, depending on developer implementation
• Manual creation of MCP interfaces is time-consuming and error-prone
• Lack of standardized conversion processes

MCP Link solves these issues through automation and standardization, allowing any API to easily join the AI-driven application ecosystem.

🌟 Key Features

• Automatic Conversion: Generate complete MCP Servers based on OpenAPI Schema
• Seamless Integration: Make existing RESTful APIs immediately compatible with AI Agent calling standards
• Complete Functionality: Ensure all API endpoints and features are correctly mapped
• Zero Code Modification: Obtain MCP compatibility without modifying the original API implementation
• Open Standard: Follow the MCP specification to ensure compatibility with various AI Agent frameworks

🌐 Online Version

Try our hosted version at mcp-link.vercel.app to quickly convert and test your APIs without installation.

🚀 Quick Start

Installation

# Clone repository
git clone https://github.com/automation-ai-labs/mcp-link.git
cd mcp-openapi-to-mcp-adapter

# Install dependencies
go mod download

Running

# Specify port
go run main.go serve --port 8080 --host 0.0.0.0

Parameter Description

• `s=` - URL of the OpenAPI specification file
• `u=` - Base URL of the target API
• `h=` - Authentication header format, in the format of `header-name:value-prefix`
• `f=` - Path filter expressions to include or exclude API endpoints. Syntax:
  • `+/path/**` - Include all endpoints under /path/
  • `-/path/**` - Exclude all endpoints under /path/
  • `+/users/*:GET` - Include only GET endpoints for /users/{id}
  • Multiple filters can be separated by semicolons: `+/:GET;-/internal/`
  • Wildcards: `*` matches any single path segment, `**` matches zero or more segments

Examples

Usage in AI Agents

{
  "mcpServers": {
    "@service-name": {
      "url": "http://localhost:8080/sse?s=[OpenAPI-Spec-URL]&u=[API-Base-URL]&h=[Auth-Header]:[Value-Prefix]"
    }
  }
}

These URLs allow any API with an OpenAPI specification to be immediately converted into an MCP-compatible interface accessible to AI Agents.

📋 Future Development

• MCP Protocol OAuthflow: Implement OAuth authentication flow support for MCP Protocol
• Resources Support: Add capability to handle resource-based API interactions
• MIME Types: Enhance support for various MIME types in API requests and responses