通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

在 API 清单中注册和发现远程 MCP 服务器

本文介绍如何使用 Azure API 中心维护远程模型上下文协议（MCP）服务器的清单（或 注册表），并帮助利益干系人使用 API 中心门户发现它们。 MCP 服务器以标准方式向使用它们的 AI 代理和模型公开后端 API 或数据源。

关于 MCP 服务器

由于增强的大型语言模型（LLM）功能，AI 代理正被广泛采用。 但是，即使是最先进的模型也面临着限制，因为它们与外部数据隔离。 每个新的数据源可能需要自定义实现来提取、准备和使数据可供模型访问。

模型上下文协议（MCP）可帮助解决此问题。 MCP 是一种开放标准，用于将 AI 模型和代理与外部数据源（例如本地数据源（数据库或计算机文件）或远程服务（通过 Internet 提供的系统（如远程数据库或 API）连接。

MCP 体系结构

下图说明了 MCP 体系结构：

模型上下文协议（MCP）体系结构示意图。

该体系结构包括以下组件：

组件 DESCRIPTION
MCP 主机 需要访问外部功能的 LLM 应用程序包括 IDE 中的聊天应用或 AI 助手（如 Visual Studio Code 中的 GitHub Copilot）
MCP 客户端 在主机应用程序内部，与服务器保持 1:1 连接的协议客户端
MCP 服务器 轻量程序每个都公开特定功能，并为客户提供上下文、工具和提示。
MCP 协议 中间的传输层

MCP 遵循客户端服务器体系结构，其中主机应用程序可以连接到多个服务器。 只要 MCP 主机或客户端需要工具，它就连接到 MCP 服务器。 然后，MCP 服务器连接到数据库或 API。 MCP 主机和服务器通过 MCP 协议相互连接。

远程与本地 MCP 服务器

MCP 利用基于 JSON-RPC 2.0 进行消息传递的客户端主机-服务器体系结构。 客户端和服务器之间的通信通过定义的传输层发生，并且主要支持两种作模式：

  • 远程 MCP 服务器 - MCP 客户端通过 Internet 连接到 MCP 服务器，使用 HTTP 和服务器发送的事件（SSE）建立连接，并使用 OAuth 授权 MCP 客户端访问用户帐户上的资源。

  • 本地 MCP 服务器 MCP 客户端使用标准输入/输出作为本地传输方法连接到同一计算机上的 MCP 服务器。

API 清单中的 MCP 服务器

以下部分介绍如何在 API 中心清点和发现远程 MCP 服务器。

MCP API 类型

若要在 API 中心清单中注册 MCP 服务器，请将 API 类型指定为 MCP。 若要使用 Azure 门户注册 API，请参阅 教程：在 API 清单中注册 API。

如以下部分所述，注册 MCP 服务器时，可以指定环境、部署和定义。

MCP 服务器的环境和部署

在 API 中心，为 MCP 服务器指定环境和部署。 环境是 MCP 服务器的位置，例如 API 管理平台或计算服务，部署是 MCP 服务的运行时 URL。

有关创建环境和部署的信息，请参阅 教程：添加 API 的环境和部署。

远程 MCP 服务器的定义

（可选）以 OpenAPI 3.0 格式为远程 MCP 服务器添加 API 定义。 API 定义必须包含 MCP 服务器的 URL 终结点。 有关添加 OpenAPI 定义的示例，请参阅 教程：在 API 清单中注册 API。

可以为您的 MCP 服务器使用以下轻量级 OpenAPI 3.0 API 定义，其中包括一个适用于 MCP 服务器的 url 终结点。

{
  "openapi": "3.0.0",
  "info": {
    "title": "Demo MCP server",
    "description": "Very basic MCP server that exposes mock tools and prompts.",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://my-mcp-server.contoso.com"
    }
  ]
}

使用 API 中心门户发现 MCP 服务器

设置 API 中心门户 ，以便组织中的开发人员和其他利益干系人可以在 API 清单中发现 MCP 服务器。 用户可以在清单中浏览和筛选 MCP 服务器，并查看 MCP 服务器的 URL 终结点（如果 MCP 服务器 API 定义中可用）的详细信息。

API 中心门户中 MCP 服务器的屏幕截图。

注释

仅当为 MCP 服务器添加 MCP 部署和 MCP 服务器的 API 定义时，MCP 服务器的 URL 终结点才显示在 API 中心门户中。

相关内容