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

🧩 架构

🤔 为什么需要 MCP Link？

当前 AI 代理生态系统存在明显差距：

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

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

🌟 核心功能

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

🌐 在线版本

在 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 协议 OAuthflow：实现 MCP 协议的 OAuth 认证流程支持
• 资源支持：添加处理基于资源的 API 交互的能力
• MIME 类型：增强 API 请求和响应中各种 MIME 类型的支持