矩尺全栈智能流量平台

主题切换

快速创建 MCP 网关 ​

简介 ​

MCP（Model Context Protocol）网关可以将您现有的 REST API 快速转化为可供 AI 大模型调用的 MCP 服务。矩尺平台根据您上传的 Swagger/OpenAPI 文档自动生成 MCP 工具描述，AI Agent 可通过标准 MCP 协议调用这些工具，平台自动将 MCP 协议中的 JSONRPC 消息转换为 REST 接口调用后端应用服务。

适用场景：

  • 将内部 REST API 以 MCP 协议暴露给 AI Agent / 大模型应用
  • 统一管理和发布 AI 可调用的工具接口
  • 对后端 API 进行流量管理、访问控制和审计

操作步骤概览 ​

第一步：上传 API 接口定义文件     → 提供 Swagger/OpenAPI 文档
第二步：创建服务器池               → 定义后端 REST API 服务节点
第三步：创建虚拟服务               → 在默认分发规则中开启 MCP，关联接口文档
第四步：变更执行并验证             → 使配置生效，用 MCP 客户端验证

您也可以在虚拟服务创建完成后，通过自定义七层分发规则单独配置 MCP 功能，虚拟服务的默认分发规则和自定义分发规则之间只能同时启用或关闭"AI 智能感知（MCP）"功能。

第一步：上传 API 接口定义文件 ​

入口：【负载流量管理 → AI 语义中心】。

  1. 在 API 接口定义文件列表，点击"新增"。
  2. 上传您的 Swagger/OpenAPI 文档（支持 YAML 或 JSON 格式）。 API接口定义文件新增

上传注意事项

  • 描述信息：API 接口的描述部分会作为 Instructions 注入大模型上下文，辅助大模型理解接口功能。请确保每个接口的描述清晰准确。
  • 引用展开深度：默认展开深度为 3 层。展开深度影响工具列表的大小（最大不可超过 10MB），请根据大模型最大 Token 上下文合理设置。
  • 自动分页：当返回给大模型的工具列表超过 50 个接口时，系统会自动按 50 个接口分页，大模型会自动处理后续加载。

第二步：创建服务器池 ​

创建标准的 HTTP 或 HTTPS 服务器池，指向您的后端 REST API 服务。操作步骤与标准 HTTP 虚拟服务的后端配置相同。

添加服务器池 ​

入口：【负载流量管理 → 服务器池】，点击"新增"：

配置项示例值说明
名称pool-mcp-api便于识别的名称
负载均衡算法轮询根据后端服务情况选择
健康检查策略使用内置默认策略或自定义创建平台提供内置健康检查策略可直接选用

在节点列表中添加后端 REST API 服务器的 IP 和端口。如需自定义健康检查策略（如指定检查路径），可参考 健康检查配置指南。

详细的服务器池配置请参考 快速创建 HTTP 虚拟服务。

第三步：创建虚拟服务 ​

入口：【负载流量管理 → 虚拟服务】，点击"新增"。

在虚拟服务配置页面，与标准 HTTP 虚拟服务的配置基本一致，额外执行以下操作：

开启 AI 智能感知（MCP） ​

在虚拟服务的默认分发规则区域，找到 "AI 智能感知（MCP）" 开关，将其打开，然后选择您在第一步上传的 API 接口定义文件。

七层分发规则配置

配置项示例值说明
名称vs-mcp-gateway便于识别的名称
监听地址0.0.0.0:8080MCP 客户端连接的入口
处理方式HTTP 代理将请求代理转发至后端 API 服务
AI 智能感知（MCP）✅ 开启选择第一步上传的 API 接口定义文件
服务器池选择第二步创建的 pool-mcp-api后端 REST API 服务节点

（可选）配置跳过验证的七层 HTTP 策略 ​

由于大模型存在"幻觉"，让 AI Agent 自行生成 Cookie 或 Token 进行认证，既增加了不确定性，也增加了 Token 消耗和任务耗时。建议通过七层 HTTP 策略预构造请求的认证信息：

  • 在默认分发规则中，选择或新建一个七层 HTTP 策略。
  • 通过 HTTP 头部或 URL 参数等方式，预填入认证 Token 或 Cookie 等凭证信息。

MCP 虚拟服务的其他配置方式（SSL 证书、限速、访问控制、日志等）与标准 HTTP/HTTPS 虚拟服务完全相同，详细步骤请参考 快速创建 HTTP 虚拟服务 或 快速创建 HTTPS 虚拟服务。

配置示意 ​

虚拟服务: vs-mcp-gateway
  监听: 0.0.0.0:8080
  处理方式: HTTP 代理
  └── 默认分发规则
        ├── AI 智能感知（MCP）: ✅ 开启
        ├── API 接口定义文件: 第一步上传的 Swagger 文档
        ├── 服务器池: pool-mcp-api
        └── 七层 HTTP 策略: （可选）预置认证信息

第四步：变更执行并验证 ​

  1. 确认所有配置填写完成后，点击"变更执行"。
  2. 等待变更生效，确认虚拟服务列表中 vs-mcp-gateway 的状态为"正常"。

客户端连接 ​

AI 客户端（如支持 MCP 协议的 AI Agent 或大模型应用）可通过标准 MCP 协议连接到虚拟服务的监听地址。连接成功后，客户端将自动发现 API 接口定义文件中定义的所有工具，并可直接调用。

观察运行状态 ​

  • 在虚拟服务详情页的 日志 标签下可查看 MCP 服务的调用记录。
  • AI 拓扑图 会根据日志自动生成，支持多维度分析调用链路。

相关文档 ​