关于 MCP Link - Convert Any OpenAPI V3 API to MCP Server
MCP Link 可将任意符合 OpenAPI V3 规范的 API 自动转换为 MCP 服务,无需修改原有 API 实现。适合希望让现有 REST API 接入 AI Agent 的开发者。项目提供托管版本,也可本地以 Go 运行。
主要功能
- 01根据 OpenAPI 规范自动生成 MCP 服务
- 02通过 URL 参数配置规范地址、基础地址与认证头
- 03使用 f 参数按路径与方法过滤端点
- 04提供多个常见服务的现成示例链接
适用场景
- 01为内部 REST API 快速提供 MCP 接口
- 02将 GitHub、Slack 或 Notion 等 API 暴露给 AI Agent
- 03在不改动后端代码的情况下测试 API 的 MCP 接入
MCP 相关
该服务以 SSE 端点的形式提供 MCP 接口,AI Agent 可通过 MCP 客户端配置的 URL 调用由 OpenAPI 端点生成的工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
http://localhost:8080/sse?s=[OpenAPI-Spec-URL]&u=[API-Base-URL]&h=[Auth-Header]:[Value-Prefix]一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http link http://localhost:8080/sse?s=[OpenAPI-Spec-URL]&u=[API-Base-URL]&h=[Auth-Header]:[Value-Prefix]Cursor.cursor/mcp.json
{"mcpServers":{"link":{"type":"http","url":"http://localhost:8080/sse?s=[OpenAPI-Spec-URL]&u=[API-Base-URL]&h=[Auth-Header]:[Value-Prefix]"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"link":{"type":"http","url":"http://localhost:8080/sse?s=[OpenAPI-Spec-URL]&u=[API-Base-URL]&h=[Auth-Header]:[Value-Prefix]"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"link":{"type":"http","url":"http://localhost:8080/sse?s=[OpenAPI-Spec-URL]&u=[API-Base-URL]&h=[Auth-Header]:[Value-Prefix]"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"link":{"serverUrl":"http://localhost:8080/sse?s=[OpenAPI-Spec-URL]&u=[API-Base-URL]&h=[Auth-Header]:[Value-Prefix]"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
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。
🚀 快速开始
安装
# Clone repository
git clone https://github.com/automation-ai-labs/mcp-link.git
cd mcp-openapi-to-mcp-adapter
# Install dependencies
go mod download
运行
# Specify port
go run main.go serve --port 8080 --host 0.0.0.0
参数说明
s=- OpenAPI 规范文件的 URLu=- 目标 API 的基础 URLh=- 身份验证标头格式,格式为header-name:value-prefixf=- 用于包含或排除 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 Agent 中使用
{
"mcpServers": {
"@service-name": {
"url": "http://localhost:8080/sse?s=[OpenAPI-Spec-URL]&u=[API-Base-URL]&h=[Auth-Header]:[Value-Prefix]"
}
}
}
这些 URL 可将任何带有 OpenAPI 规范的 API 立即转换为兼容 MCP、可供 AI Agent 访问的接口。
📋 未来开发
- MCP 协议 OAuthflow:为 MCP 协议实现 OAuth 身份验证流程支持
- 资源支持:增加处理基于资源的 API 交互的能力
- MIME 类型:增强对 API 请求和响应中各种 MIME 类型的支持
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。