API-to-MCP，并在 Dify 实现调用的实践

Release Time 2025-05-07

背景

MCP（Model Context Protocol，模型上下文协议）是Anthropic于2024年11月发布的开源通信标准，其核心目标是通过建立统一的交互范式，消除大型语言模型（LLM）与异构数据源、工具间的集成壁垒。该协议通过三层次革新解决AI领域的数据孤岛问题，实现本地数据和互联网数据，基于MCP就可以实现事实上的”万物互联“，包括但不限于，数据和文件系统，操作阿里云上任意资源，浏览器自动化等等。

这项技术突破使得AI应用真正实现”万物互联”——从个人设备的文档处理到企业级云资源调度，均可通过统一协议完成智能交互

图1 MCP协议官方架构图

然而，企业普遍面临的挑战是：如何将已有的OpenAPI高效地转化为AI助手可直接调用的MCP工具？本文将详细介绍如何通过Higress实现这一转化过程，让您的存量API在Dify等AI平台上焕发新生。

问题拆解与实现方案

我们将问题拆解为五个核心子问题：

将存量OpenAPI的Schema转换为MCP配置
通过Higress将请求路由到OpenAPI
实现OpenAPI和MCP的双重鉴权
选择合适协议连接AI助手
优化提示词提升MCP工具效能

下面以高德API为例，详细介绍实现过程：

步骤一：将OpenAPI Schema转换为MCP配置

OpenAPI 采用 YAML 或 JSON 编写，定义了一个与语言无关的 HTTP API 接口，为 API 生命周期各阶段提供统一的信息传递方式。而 API 允许开发者在无须访问源代码的情况下，就可以发现并使用相应的服务。例如，一个社交 APP，想获取双方的地理位置信息，无须自建一个高德地图，也无须获取高德地图源码，而是通过高德地图的 API 接口，即可获得其地理位置信息的功能。

一个标准的OpenAPI.json的Schema如下所示：

我们需要一个工具，提取出这里面的关键信息，如路径，方法，参数，响应格式等，然后基于MCP的规范，转换为新的描述，返回给客户端。

那么此处，可以使用Higress出品的openapi-to-mcp工具，直接将上述重复，繁琐的过程给自动化，输入一个Json，得到一个标准MCP的配置

步骤二：通过Higress配置API路由

Higress作为云原生网关，可以优雅地将请求路由到后端OpenAPI服务。完整手工操作可参考此文，大致流程如下：

Configmap全局参数配置MCP server
配置存量API的服务来源。如果此处有多个存量API块，建议每个块建一个服务来源
新建路由配置，并将步骤一种的MCP yaml配置传入。

此处推荐自动化的操作方式，可以将Higress的OpenAPI喂到Deepseek大模型，让其帮实现一个client，实现自动的配置以上步骤。

higress的OpenAPI可访问此地址

步骤三: 双重鉴权实现

正如前面所有，这里实际包含两部分鉴权：

higress路由到存量OpenAPI时，higress与API之前的鉴权
用户在访问higress的sse链接时，用户与higress之间的鉴权

Higress与后端API间的鉴权：

访问之前配置的路由，点击策略
找到MCP服务器配置，在生成的MCP配置中，可以找到每个request的请求头，我们根据存量API实际的鉴权方式，添加相应的请求头，如下图所示：

用户与Higress间的鉴权：

通过消费者管理鉴权。

访问“消费者管理”界面，创建消费者
选择合适的名称和令牌来源，此处支持三种认证方式，我们这里就用最简单的KeyAuth认证
找到之前新建的路由，点击“编辑”。
启用请求验证，并指定消费者。
在用户使用Higress上发布的MCP服务时，就需要携带刚刚指定的apikey。比如

{
  "amap-maps": {
    "headers": {
      "Authorization": "Bearer xxx"
    },
    "transport": "sse",
    "url": "http://12xx.94:8080/amap-maps/sse"
  }
}