AI导哈

MCP服务器托管服务

在Azure Functions上托管使用官方MCP SDK构建的远程MCP服务器，提供无服务器架构的扩展性和安全性。

  • by Azure-Samples
  • Bicep
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Azure-Samples/mcp-sdk-functions-hosting-java

使用说明

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

此存储库包含运行模型上下文协议（MCP）服务器的说明和示例，该服务器使用 Java/Quarkus Azure功能。该示例是一个简单的天气服务器，您可以克隆它以在本地运行，并在几分钟内使用Azure Developer CLI部署到云端。

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

Azure功能MCP扩展 允许开发人员使用Function触发器和绑定构建MCP服务器，这本质上是Function的事件驱动编程框架。这些MCP服务器可以像任何Function App一样远程托管在无服务器平台上。

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

此回购侧重于第二种情况：

先决条件

在本地测试服务器

  1. 克隆仓库并导航到 quarkus-mcp-server 目录：
    git clone https://github.com/Azure-Samples/mcp-sdk-functions-hosting-java.git 
cd quarkus-mcp-server
  2. 使用调试配置文件构建服务器：
    mvn clean package -P debug
  3. 导航到 target/azure-functions/quarkus-mcp 然后启动服务器：
    cd target/azure-functions/quarkus-mcp 
func start
  4. 打开 .vcode/mcp.json 并通过单击启动服务器 开始 按钮上方 本地mcp服务器。一旦服务器显示可用工具的数量，就可以使用了。
  5. 点击顶部的Copilot图标打开聊天(Ctrl+Command+I / Ctrl+Alt+I)，然后更改为 代理 问题窗口中的模式。
  6. 单击工具图标并确保 本地mcp服务器 已检查Copilot是否在聊天中使用：
  7. 询问“使用#local mcp服务器返回纽约市的天气。”副驾驶应调用其中一个天气工具来帮助回答这个问题。
  8. 完成测试后停止服务器 Ctrl+C.

部署

  1. 在 quarkus-mcp-server 目录，构建服务器进行部署：

    mvn clean package

  2. 创建一个新的azd项目环境。环境的名称将成为部署Azure资源的资源组名称：

    azd env new <environment-name>

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

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

    [！注意] 使用Microsoft租户的Microsoft员工必须提供服务管理参考（您的服务树ID）： azd env set SERVICE_MANAGEMENT_REFERENCE <ID>。没有它，您将无法创建Entra应用程序注册，并且配置将失败。

  4. 跑 azd up 在 根目录 （其中 azure.yaml 是）。选择一个Azure订阅以将资源部署到可用区域并从中进行选择（例如美国东部）。如果愿意，请启用vnet。

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

      (✓) 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 mcp
  - Endpoint: https://functionapp-name.azurewebsites.net/

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

  1. 打开 .vcode/mcp.json 在编辑。
  2. 单击停止本地服务器 停止 按钮上方 本地mcp服务器.
  3. 单击启动远程服务器 开始 按钮上方 远程mcp服务器.
  4. Visual Studio代码将提示您输入函数应用程序名称。从终端输出或门户复制它，然后按enter键。
  5. Visual Studio代码现在应该提示您向Microsoft进行身份验证。点击 允许，然后登录到您的电子邮件帐户（用于访问Azure门户的帐户）。假设您能够登录，过一会儿您应该会看到可用的工具数量。
  6. 在代理模式下打开Copilot并确保 远程mcp服务器 已在工具列表中选中。
  7. 询问Copilot“使用#remote mcp服务器返回西雅图的天气”。

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

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

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

服务器应用程序配置了 内置服务器身份验证和授权 功能，它实现了 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工具。

重新部署

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

[！注意] 部署的代码文件总是被最新的部署包覆盖。

E2E测试

基于最小节点的端到端测试运行器：

cd e2e
npm install
npm test

备注

  • host*.json 模板在包时解析运行器JAR名称

相关 MCP