AI导哈

Azure Functions托管MCP服务器

在Azure Functions上托管使用官方MCP SDK构建的远程MCP服务器，支持快速部署和本地测试。

  • by charanadi4u
  • Bicep
  • 本地部署
  • 更新于
在 GitHub 查看 charanadi4u/mcp-sdk-functions-hosting-python

使用说明

在Azure Functions上使用官方MCP SDK构建的主机远程MCP服务器（早期预览）

此仓库包含在Azure Functions上运行使用Python MCP SDK构建的MCP服务器的说明和示例。该仓库使用天气样本服务器来演示如何做到这一点。您可以克隆以在本地运行和测试服务器，然后轻松部署 azd up 几分钟后就可以把它放在云端了。

观看视频概述

在Azure Functions上以自定义处理程序运行MCP服务器

Azure Functions最近发布了 MCP扩展功能，允许开发人员使用Function编程模型构建MCP服务器，该模型本质上是Function的事件驱动框架，并在无服务器平台上远程托管它们。

对于那些已经构建了服务器的人 Anthropic的MCP SDK，也可以通过以下方式在Azure Functions上托管服务器： 自定义处理程序，它们是从Functions主机接收事件的轻量级web服务器。它们允许您托管已经构建的MCP服务器，而无需更改代码，并受益于Function的突发规模、无服务器定价模型和安全功能。

此仓库侧重于第二种托管场景：

先决条件

确保您拥有以下内容：

[！注意] 此示例要求您具有创建 微软Entra应用程序 在您使用的Azure订阅中。

如果您已经有一个现有的服务器。..

[！重要] 您的服务器必须 无状态 并使用 可流式传输http 今天，传输将远程托管在Azure Functions上。

以下说明将引入本地服务器测试和部署所需的工件。最重要的是： host.json, local.settings.json，以及 infraAzure Functions只需要前两个JSON文件。这 infra 目录不是必需的，但它对于配置Azure资源很方便。

你的项目不太可能有同名的文件和目录，但如果有，你需要重命名它们，这样它们就不会被覆盖。

完成必要的重命名后，请按照以下步骤操作：

  1. 在MCP服务器项目中，运行 azd init --template self-hosted-mcp-scaffold-python.
  2. 回答提示
    • 是否继续初始化“/your/mcp/project/文件夹”中的应用程序？：选择“是”。
    • 文件既存在于本地，也存在于模板中：可能唯一的文件是README，您可以保留现有的文件。
    • 输入一个唯一的环境名称：这将成为部署服务器的资源组的名称。
  3. 在 host.json:
    • 将主Python脚本路径设置为 arguments例如。 weather.py
    • 确保 port 值与MCP服务器使用的值相同
  4. 按照从中开始的说明进行操作 在本地测试服务器 部分。

您可以了解更多关于 模板.

如果你从头开始。..

克隆仓库并在Visual Studio Code中打开示例

git clone https://github.com/Azure-Samples/mcp-sdk-functions-hosting-python.git

在本地测试服务器

  1. 在根目录中，运行 uv run func start 创建虚拟环境、安装依赖项并在本地启动服务器
  2. 打开 mcp.json （在 .vcode 目录）
  3. 通过选择启动服务器 开始 按钮上方 本地mcp服务器
  4. 点击顶部的Copilot图标打开聊天（或 Ctrl+Command+I / Ctrl+Alt+I)，然后更改为 代理 问题窗口中的模式。
  5. 单击工具图标并确保 本地mcp服务器 已检查Copilot是否在聊天中使用：
  6. 服务器显示可用工具的数量后，询问“使用#local mcp服务器返回纽约市的天气”。副驾驶应调用其中一个天气工具来帮助回答这个问题。
  7. 停用虚拟环境

[！注意] 当服务器在本地启动时，Azure Functions主机首先ping根(/)以确保应用程序已启动并运行。由于根未实现，因此返回404。

默认情况下，来自MCP SDK的信息日志可能会写入stderr，这就是为什么它们在Azure Functions中显示为红色的原因。

部署前注册资源提供程序

在部署之前，您需要注册 Microsoft.App 资源提供者：

az provider register --namespace 'Microsoft.App'

等待几秒钟以完成注册。您可以使用以下命令检查状态：

az provider show -n Microsoft.App

部署

  1. 此示例使用Visual Studio Code作为主客户端。将其配置为允许的客户端应用程序：

    azd env set PRE_AUTHORIZED_CLIENT_IDS aebc6443-996d-45c2-90f0-388ff96faa56

  2. 如果您的组织需要，请指定服务管理参考。如果您不是Microsoft员工，并且不知道需要设置此项，则可以跳过此步骤。但是，如果配置失败，并出现缺少服务管理引用的错误，您可能需要重新访问此步骤。使用Microsoft租户的Microsoft员工必须提供服务管理参考（您的服务树ID）。否则，您将无法创建Entra应用程序注册，并且配置将失败。

    azd env set SERVICE_MANAGEMENT_REFERENCE <service-management-reference>

  3. 跑 azd up 在根目录中。然后选择一个Azure订阅来部署资源，并从可用区域中进行选择。

    部署完成后，您的终端将显示类似于以下内容的输出：

      (✓) Done: Resource group: rg-resource-group-name (12.061s)
  (✓) Done: App Service plan: plan-random-guid (6.748s)
  (✓) Done: Virtual Network: vnet-random-guid (8.566s)
  (✓) Done: Log Analytics workspace: log-random-guid (29.422s)
  (✓) Done: Storage account: strandomguid (34.527s)
  (✓) Done: Application Insights: appi-random-guid (8.625s)
  (✓) Done: Function App: func-mcp-random-guid (36.096s)
  (✓) Done: Private Endpoint: blob-private-endpoint (30.67s)

  Deploying services (azd deploy)
  (✓) Done: Deploying service api
  - Endpoint: https://functionapp-name.azurewebsites.net/

在Visual Studio代码上连接到服务器

  1. 打开 mcp.json 在编辑。
  2. 通过选择以下选项停止本地服务器 停止 按钮上方 本地mcp服务器.
  3. 通过选择启动远程服务器 开始 按钮上方 远程mcp服务器.
  4. Visual Studio代码将提示您输入函数应用程序名称。从终端输出或门户复制它。
  5. 在代理模式下打开Copilot，并确保 远程mcp服务器 已在工具列表中选中。
  6. VS Code应提示您向Microsoft进行身份验证。点击 允许，然后登录到您的Microsoft帐户（用于访问Azure门户的帐户）。
  7. 询问Copilot“使用#remote mcp服务器返回西雅图的天气”。它应该调用一个天气工具来帮助回答。

[！提示] 除了在中启动MCP服务器外 mcp.json，您可以通过单击查看服务器的输出 更多。.. -> 显示输出。输出提供了有用的信息，例如连接可能失败的原因。

您还可以单击齿轮图标将日志级别更改为“跟踪”，以获取有关客户端（Visual Studio代码）和服务器之间交互的更多详细信息。

重新部署

如果要在更改后重新部署服务器，请运行 azd deploy。（参见azd命令 参考.)

内置服务器身份验证和授权

服务器应用程序配置了内置的服务器身份验证和授权功能，该功能实现了 MCP授权规范例如发出401质询并暴露受保护资源元数据（PRM）。

在Visual Studio Code的调试输出中，您可以看到MCP客户端和服务器交互时的一系列请求和响应。使用内置MCP服务器授权时，您应该看到以下事件序列：

  1. 编辑器向MCP服务器发送初始化请求。
  2. MCP服务器返回一个错误，表示需要授权。响应包括指向应用程序的受保护资源元数据（PRM）的指针。内置的授权功能为服务器应用程序生成PRM。
  3. 编辑器获取PRM并使用它来标识授权服务器。
  4. 编辑器尝试从授权服务器上的已知端点获取授权服务器元数据（ASM）。
  5. Microsoft Entra ID不支持已知端点上的ASM，因此编辑器转而使用OpenID Connect元数据端点来获取ASM。它试图通过在任何其他路径信息之前插入已知的端点来发现这一点。
  6. OpenID Connect规范实际上将众所周知的端点定义为路径信息之后，这就是Microsoft Entra ID托管它的地方。因此，编辑器会再次尝试使用这种格式。
  7. 编辑器成功检索ASM。然后，它将此信息与自己的客户端ID结合使用以执行登录。此时，编辑器会提示您登录并同意该应用程序。
  8. 假设您成功登录并同意，编辑器将完成登录。它向MCP服务器重复初始化请求，这次在请求中包含授权令牌。此重新尝试在调试输出级别不可见，但您可以在跟踪输出级别看到它。
  9. MCP服务器验证令牌，并对初始化请求作出成功响应。标准MCP流程从这一点开始继续，最终发现了本示例中定义的MCP工具。

支持其他客户

除了Visual Studio Code之外，Azure AI Foundry中的代理还可以连接到配置了Easy Auth的Function托管的MCP服务器。文档即将发布。

清理资源

使用完服务器后，您可以使用此命令删除在Azure上创建的资源，从而避免产生任何进一步的成本：

azd down

下一步

在其他语言中查找此示例

语言（堆栈） 回购位置
C#（.NET） mcp-sdk函数托管
节点 mcp-sdk功能托管节点

故障排除

以下是一些常见的问题。

  1. InternalServerError:发生意外的InternalServerError。请稍后再试。

    检查您是否已注册 Microsoft.App 资源提供者：

    az provider show -n Microsoft.App

    如果它显示为未注册，请注册它：

    az provider register --namespace 'Microsoft.App'

    成功注册应显示：

    Namespace      RegistrationPolicy    RegistrationState
-------------  --------------------  -------------------
Microsoft.App  RegistrationRequired  Registered

    然后运行 azd up 再一次。

  2. 错误：执行步骤命令“deploy--all”时出错：获取目标资源：未找到资源：找不到标记为“azd服务器名称：api”的资源。确保基础结构配置中的服务资源标记已更正，然后重新运行配置

    这是一个 已知瞬态误差。尝试重新运行 azd up.

  3. 确保您安装了最新版本的Azure Functions核心工具。

    你需要 版本>=4.5.0.运行检查 func --version.

  4. .vscode/mcp.json 必须位于VS Code的根目录中，才能检测MCP服务器注册

    如果你没有看到 开始 服务器注册上方的按钮，这可能是因为 .vscode/mcp.json 不在工作区文件夹的根目录中。

相关 MCP