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

注册 Azure API 中心 Azure Functions 中托管的 MCP 服务器

在 Azure Functions 上远程托管 MCP 服务器后,请在 Azure API 中心注册它。 Azure API 中心维护远程 MCP 服务器的清单(或注册表),以便在整个组织中轻松发现它们。 所有已注册的 MCP 服务器都显示在组织中团队的 API 中心门户中。

显示 MCP 服务器的 API 中心门户

小窍门

API 中心名称将成为注册表筛选器中的专用工具目录名称。 选择有助于用户识别组织工具目录的信息性名称。

创建资源

  1. 登录到 Azure 门户,然后 创建一个 Azure API 中心资源(如果还没有)。

  2. 在 API 中心资源中创建环境。 对于 服务器>类型,请选择 “Azure Functions”。

注册 MCP 服务器

通过将远程 MCP 服务器添加为 API 来注册它:

  1. 在 API 中心资源的左侧导航窗格中,选择 API

  2. 选择 “+ 注册 API”。 下表提供了所需设置的示例值。 还可以填写可选设置,例如 MCP 服务器说明、存储库、外部文档,以及 API 中心门户中显示的其他信息。

    设置 价值
    API 标题 输入 MCP 服务器的描述性名称,例如 Weather MCP Server
    标识 此值基于 API 标题自动生成,但可以对其进行修改。
    API 类型 MCP
    运行时 URL 输入 MCP 服务器终结点,例如 https://contoso.azurewebsites.net/mcp
    环境 选择之前创建的环境。
    版本标题 输入所选的版本标题,例如 v1
    版本标识 输入前面的标题后,Azure API 中心会生成此标识符,你可以替代该标识符。
    版本生命周期 从下拉列表中选择最合适的值,例如 测试生产
  3. 选择 创建

    现在应会看到 MCP 服务器在列表中注册为 API。

更新服务器定义

  1. 使用 OpenAPI 3.0 格式为远程 MCP 服务器创建 API 定义。 需要此定义,以便 API 中心门户显示 MCP 服务器的 URL 终结点。 保存定义以便访问。 需要在下一步中上传该服务器。

    MCP 服务器的示例 OpenAPI 3.0 API 定义:

    {
        "openapi": "3.0.0",
        "info": {
            "title": "Weather MCP server",
            "description": "MCP server with tools returning weather forecast and alerts.",
            "version": "1.0"
        },
        "servers": [
            {
                "url": "https://my-mcp-server.azurewebsites.net/mcp"
            }
        ]
    }
    
  2. 更新服务器定义:

    a。 在左侧菜单中,找到 资产 -> API

    b. 选择 MCP 服务器名称以打开注册。

    c. 在左侧菜单中,找到 详细信息 -> 版本

    d. 在“版本”下,找到并展开“v1”。 然后选择 “可流定义...” 以打开定义。

    d. 选择 替换

    e. 在打开的侧窗格中,将“规范版本”更改为 3.0,然后从上一步上传定义。

    f. 选择 替换

设置 API 中心门户

  1. 如果还没有一个门户,请设置好一个门户

  2. 门户设置完成后,你可以通过 https://<service-name>.portal.<location>.azure-apicenter.ms 访问它。 将 <service-name><location> 替换为 API 中心的名称及其部署位置。 需要登录才能看到已注册的 MCP 服务器。

  3. 选择服务器名称时,将打开一个窗格,该窗格会根据在服务器注册期间提供的数据和上传的 API 定义显示信息。 有权访问门户的用户可通过复制终结点 URL 或 Visual Studio Code 集成中的安装程序,连接到自己选择的服务器。

    API 中心门户中的服务器信息

关于 Azure API 管理中的 MCP 服务器