通过

你当前正在访问 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 主机或客户端需要工具，它就连接到 MCP 服务器。 然后，MCP 服务器连接到数据库或 API。 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 的方式，将 API 类型指定为 MCP。 若要使用 Azure 门户注册 API，请参阅 教程：在 API 清单中注册 API。

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

Tip

如果您在 Azure API 管理中管理 MCP 服务器，可以启用自动同步功能，以确保您的 API 中心与 MCP 服务器以及来自 API Management 实例的其他 API 始终保持最新。 若要了解详细信息，请参阅 从 Azure API 管理实例同步 API。

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"
    }
  ]
}

注册合作伙伴 MCP 服务器

Azure API 中心提供可添加到 API 清单的合作伙伴 MCP 服务器的特选列表。 此列表包括来自 Microsoft 服务（例如 Azure 逻辑应用、GitHub 等）的 MCP 服务器。

在 API 清单中注册一个或多个合作伙伴 MCP 服务器，使其可供组织中的开发人员和其他利益干系人使用。

门户中合作伙伴 MCP 服务器的屏幕截图。

注册合作伙伴 MCP 服务器：

  1. 在 Azure 门户中，导航到 API 中心。
  2. 在边栏菜单中的 “发现”下，选择 “MCP ”（预览）。
  3. 浏览可用的合作伙伴 MCP 服务器。 选择 “注册 ”，将 MCP 服务器添加到 API 清单。 如果提供了完成注册，请按照屏幕上的说明进行作。

添加合作伙伴 MCP 服务器时，API 中心会自动为你配置以下内容：

  • 在 API 清单中创建 API 条目，并将 API 类型设置为 MCP。
  • 为 MCP 服务器创建环境和部署。
  • 如果合作伙伴可用，请为 MCP 服务器添加 OpenAPI 定义。

若要生成和注册逻辑应用 MCP 服务器，请参阅 生成和注册逻辑应用 MCP 服务器。

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

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

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

Note

仅当在 API 中心中配置 MCP 服务器的 MCP 部署和 MCP 服务器的 API 定义时，MCP 服务器的 URL 终结点才可见。

相关内容