Azure Functions 的模型上下文协议绑定概述

模型上下文协议（MCP）是一种客户端-服务器协议，旨在使语言模型和代理能够更有效地发现和使用外部数据源和工具。

Azure Functions MCP 扩展允许使用 Azure Functions 创建远程 MCP 服务器。 这些服务器可以托管 MCP 工具触发器函数，MCP 客户端（如语言模型和代理）可以查询和访问以执行特定任务。

先决条件

• 使用 SSE 传输时，MCP 扩展依赖于默认主机存储帐户 （） 提供的 Azure 队列存储。AzureWebJobsStorage 使用基于标识的连接时，请确保函数应用在主机存储帐户中至少具有这些基于角色的权限：存储队列数据读取器和存储队列数据消息处理器。
• 在本地运行时，MCP 扩展需要 Azure Functions Core Tools 版本 4.0.7030 或更高版本。

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.0.0, 5.0.0)"
    }
}

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.28.0, 5.0.0)"
  }
}

host.json 设置

本部分介绍版本 2.x 及更高版本中此绑定可用的配置设置。 host.json 文件中的设置将应用于函数应用实例中的所有函数。 有关函数应用配置设置的详细信息，请参阅 Azure Functions 的host.json 参考。

可以使用该 extensions.mcp 部分 host.json 来定义 MCP 服务器信息。

{
  "version": "2.0",
  "extensions": {
    "mcp": {
      "instructions": "Some test instructions on how to use the server",
      "serverName": "TestServer",
      "serverVersion": "2.0.0",
      "encryptClientState": true,
      "messageOptions": {
        "useAbsoluteUriForEndpoint": false
      },
      "system": {
        "webhookAuthorizationLevel": "System"
      }
    }    
  }
}

连接到 MCP 服务器

若要连接到函数应用公开的 MCP 服务器，需要为 MCP 客户端提供相应的终结点和传输信息。 下表显示了 Azure Functions MCP 扩展支持的传输及其相应的连接终结点。

¹ 个较新的协议版本已弃用 Server-Sent 事件传输。 除非客户端特别需要它，否则应改用可流式传输 HTTP 传输。

在 Azure 中托管时，扩展公开的终结点也需要命名mcp_extension。 如果未在 HTTP 标头或x-functions-key查询字符串参数中code提供，客户端将收到401 Unauthorized响应。 可以通过将system.webhookAuthorizationLevel属性host.jsonAnonymous设置为 . 有关详细信息，请参阅 host.json 设置 部分。

可以使用 Get 函数访问密钥中所述的任何方法检索密钥。 以下示例演示如何使用 Azure CLI 获取密钥：

az functionapp keys list --resource-group <RESOURCE_GROUP> --name <APP_NAME> --query systemKeys.mcp_extension --output tsv

MCP 客户端以各种方式接受此配置。 请参阅所选客户端的文档。 以下示例演示了一个 mcp.json 文件，就像在 Visual Studio Code 中为 GitHub Copilot 配置 MCP 服务器一样。 该示例使用可流式传输 HTTP 传输设置两个服务器。 第一个是使用 Azure Functions Core Tools 进行本地测试。 第二个用于 Azure 中托管的函数应用。 配置采用 Visual Studio Code 首次运行远程服务器时提示的输入参数。 使用输入可确保不会将系统密钥等机密保存到文件中并签入源代码管理。

{
    "inputs": [
        {
            "type": "promptString",
            "id": "functions-mcp-extension-system-key",
            "description": "Azure Functions MCP Extension System Key",
            "password": true
        },
        {
            "type": "promptString",
            "id": "functionapp-host",
            "description": "The host domain of the function app."
        }
    ],
    "servers": {
        "local-mcp-function": {
            "type": "http",
            "url": "http://localhost:7071/runtime/webhooks/mcp"
        },
        "remote-mcp-function": {
            "type": "http",
            "url": "https://${input:functionapp-host}/runtime/webhooks/mcp",
            "headers": {
                "x-functions-key": "${input:functions-mcp-extension-system-key}"
            }
        }
    }
}

相关文章

• 在远程 MCP 服务器中创建工具终结点
• 配置内置的 MCP 服务器授权