mcp-link：将任意OpenAPI V3 API轻松转换为MCP服务器

最新推荐文章于 2025-05-20 17:45:39 发布

龚盼韬

最新推荐文章于 2025-05-20 17:45:39 发布

阅读量915

点赞数 12

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00650/article/details/146974210

mcp-link：将任意OpenAPI V3 API轻松转换为MCP服务器

mcp-link Seamlessly Integrate Any API with AI Agents 项目地址: https://gitcode.com/gh_mirrors/mc/mcp-link

在当前AI Agent生态系统中，mcp-link无疑是一款填补重要空白的强大工具。

项目介绍

mcp-link是一个开源项目，旨在将任何OpenAPI V3 API自动转换为MCP（Machine Control Protocol）服务器。它通过自动化和标准化解决了现有生态系统中的一些关键问题，如大部分MCP服务器仅是Web API的简单封装，功能接口可能不完整，手动创建MCP接口既耗时又容易出错，以及缺乏标准化的转换流程。

项目技术分析

mcp-link的核心是基于OpenAPI Schema自动生成完整的MCP服务器。其架构清晰，易于集成，并且保证了所有API端点和特性的正确映射。项目使用Go语言开发，支持通过命令行参数进行灵活配置，包括指定端口号、API规范文件URL、目标API基础URL、认证头格式以及路径过滤表达式等。

项目及技术应用场景

mcp-link适用于多种场景，特别是那些需要将现有RESTful API快速集成到AI-driven应用生态系统的开发者。以下是几个应用实例：

自动化测试：通过将现有API转换为MCP服务器，开发者可以轻松地在自动化测试环境中使用这些API。
智能代理集成：AI Agent可以方便地通过MCP协议与转换后的API进行交互，从而实现更智能的决策支持和流程自动化。
第三方服务集成：对于需要连接多个服务以构建复合应用的场景，mcp-link可以极大地简化集成过程。

项目特点

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

在线体验

你可以在mcp-link.vercel.app上尝试mcp-link的在线版本，快速转换和测试你的API，而无需安装任何软件。

快速上手

以下是mcp-link的基本使用方法：

安装

# 克隆仓库
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端点。

示例

| 图标 | API | MCP Link URL | 认证方式 | |------|-----|-------------|---------| | | Brave Search | https://mcp-link.vercel.app/links/brave | API Key | | | DuckDuckGo | https://mcp-link.vercel.app/links/duckduckgo | None | | | 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]"
    }
  }
}

以上配置使得任何具有OpenAPI规范的API都能立即转换为AI Agent可访问的MCP兼容接口。