MCP Link - 将任何 OpenAPI V3 API 转换为 MCP 服务器

🧩 架构

🤔 为什么选择 MCP Link？

当前的 AI Agent 生态系统中存在一个显著的空白：

• 大多数 MCP 服务器只是对 Web API 的简单封装
• 功能接口可能并不完整，具体取决于开发者的实现
• 手动创建 MCP 接口既耗时又容易出错
• 缺乏标准化的转换流程

MCP Link 通过自动化和标准化解决了这些问题，使任何 API 都能轻松接入由 AI 驱动的应用生态系统。

🌟 核心特性

• 自动转换：基于 OpenAPI Schema 自动生成完整的 MCP 服务器
• 无缝集成：让现有的 RESTful API 立即兼容 AI Agent 的调用标准
• 功能完备：确保所有 API 端点和功能都被正确映射
• 零代码修改：无需修改原始 API 实现即可获得 MCP 兼容性
• 开放标准：遵循 MCP 规范，确保与各类 AI Agent 框架的兼容性

🌐 在线版本

请访问 mcp-link.vercel.app，体验我们的托管版本，无需安装即可快速转换并测试您的 API。

🚀 快速入门

安装

# 克隆仓库
git clone https://github.com/automation-ai-labs/mcp-link.git
cd mcp-openapi-to-mcp-adapter

# 安装依赖
go mod download

运行

# 指定端口
go run main.go serve --port 8080 --host 0.0.0.0

参数说明

• s= - OpenAPI 规范文件的 URL
• u= - 目标 API 的基础 URL
• h= - 认证头格式，格式为 header-name:value-prefix
• f= - 用于包含或排除 API 端点的路径过滤表达式。语法：
  • +/path/** - 包含 /path/ 下的所有端点
  • -/path/** - 排除 /path/ 下的所有端点
  • +/users/*:GET - 仅包含 /users/{id} 的 GET 端点
  • 多个过滤器可用分号分隔：+/**:GET;-/internal/**
  • 通配符：* 匹配任意单个路径段，** 匹配零个或多个路径段

示例

_	API	MCP Link URL	认证方式
	Brave Search	https://mcp-link.vercel.app/links/brave	API Key
	DuckDuckGo	https://mcp-link.vercel.app/links/duckduckgo	无
	Figma	https://mcp-link.vercel.app/links/figma	API Token
	GitHub	https://mcp-link.vercel.app/links/github	Bearer Token
	Home Assistant	https://mcp-link.vercel.app/links/homeassistant	Bearer Token
	Notion	https://mcp-link.vercel.app/links/notion	Bearer Token
	Slack	https://mcp-link.vercel.app/links/slack	Bearer Token
	Stripe	https://mcp-link.vercel.app/links/stripe	Bearer Token
	TMDB	https://mcp-link.vercel.app/links/tmdb	Bearer Token
	YouTube	https://mcp-link.vercel.app/links/youtube	Bearer Token

在 AI 代理中的使用

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

这些 URL 使得任何具有 OpenAPI 规范的 API 都能立即转换为可被 AI 代理访问的 MCP 兼容接口。

📋 未来开发计划

• MCP 协议 OAuth 流程：实现对 MCP 协议 OAuth 认证流程的支持
• 资源支持：增加处理基于资源的 API 交互的能力
• MIME 类型：增强对 API 请求和响应中各种 MIME 类型的支持

MCP Link 快速上手指南

MCP Link 是一个自动化工具，可将任何 OpenAPI V3 规范的 API 无缝转换为 MCP（Model Context Protocol）服务器，让现有 RESTful 接口立即兼容 AI Agent 调用标准。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux、macOS 或 Windows
• 核心依赖：已安装 Go (Golang) (建议版本 1.20+)
  • 国内加速：若下载 Go 较慢，可配置国内镜像源：

  export GOPROXY=https://goproxy.cn,direct
  

• 前置知识：拥有目标服务的 OpenAPI Specification (JSON/YAML) URL 及 API 基础地址。

安装步骤

通过克隆仓库并安装依赖即可完成部署：

# 1. 克隆项目仓库
git clone https://github.com/automation-ai-labs/mcp-link.git
cd mcp-openapi-to-mcp-adapter

# 2. 下载 Go 依赖
go mod download

基本使用

1. 启动服务

运行以下命令启动 MCP Link 服务器。默认监听本地 8080 端口：

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

2. 配置 AI Agent

在您的 AI Agent 配置文件（如 settings.json 或 MCP 客户端配置）中，添加如下服务器配置。请将占位符替换为您的实际 API 信息：

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

参数说明：

• s= : OpenAPI 规范文件的 URL 地址。
• u= : 目标 API 的基础 URL (Base URL)。
• h= : 认证头格式，形如 Authorization:Bearer (注意冒号后包含空格前缀)。

3. 进阶用法（可选）

如需过滤特定接口或自定义认证，可在启动命令或 URL 参数中使用以下选项：

• 接口过滤 (f=)：
  • 仅包含 GET 请求：+/users/*:GET
  • 排除内部接口：-/internal/**
  • 组合使用：+/**:GET;-/internal/**
• 在线测试： 无需本地安装，可直接访问 mcp-link.vercel.app 快速生成并测试链接。