Общие сведения о привязках протокола контекста модели для Функций Azure

Протокол контекста модели (MCP) — это протокол клиентского сервера, предназначенный для обеспечения более эффективного обнаружения и использования внешних источников данных и средств.

Расширение MCP функций Azure позволяет использовать Функции Azure для создания удаленных серверов MCP. Эти серверы могут размещать функции триггера средства MCP, которые клиенты MCP, такие как языковые модели и агенты, могут запрашивать и получать доступ к определенным задачам.

Prerequisites

• При использовании транспорта SSE расширение MCP использует хранилище очередей Azure, предоставляемое учетной записью хранения узла по умолчанию (AzureWebJobsStorage). При использовании подключений на основе удостоверений убедитесь, что ваше приложение-функция имеет по крайней мере эквиваленты этих разрешений на основе ролей в учетной записи хранения узла: средство чтения данных очереди хранилища и обработчик данных очереди хранилища.
• При локальном выполнении расширения MCP требуется версия 4.0.7030 основных средств Функций Azure или более поздняя версия.

{
    "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.29.0, 5.0.0)"
  }
}

Параметры файла host.json

В этом разделе описаны параметры конфигурации, доступные для этой привязки в версии 2.x и более поздних версиях. Параметры в файле host.json применяются ко всем функциям в экземпляре приложения-функции. Дополнительные сведения о параметрах конфигурации приложения-функции см. вhost.json справочнике по функциям Azure.

Раздел можно использовать для 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 соответствующую конечную точку и сведения о транспорте. В следующей таблице показаны транспорты, поддерживаемые расширением MCP функций Azure, а также соответствующая конечная точка подключения.

¹ Более новые версии протокола устарели для транспорта событий Server-Sent. Если клиент не требует его специально, вместо этого следует использовать транспорт HTTP с возможностью потоковой передачи.

При размещении в Azure по умолчанию конечные точки, предоставляемые расширением, также требуют системного ключа.mcp_extension Если он не указан в заголовке x-functions-key HTTP или в параметре code строки запроса, клиент получает 401 Unauthorized ответ. Это требование можно удалить, задав system.webhookAuthorizationLevel для свойства значение host.jsonAnonymous . Дополнительные сведения см. в разделе host.json параметров .

Ключ можно получить с помощью любого из методов, описанных в разделе "Получить ключи доступа к функциям". В следующем примере показано, как получить ключ с помощью Azure CLI:

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

Клиенты MCP принимают эту конфигурацию различными способами. Ознакомьтесь с документацией по выбранному клиенту. В следующем примере показан mcp.json файл, как можно использовать для настройки серверов MCP для GitHub Copilot в Visual Studio Code. В примере настраивается два сервера, как с помощью транспорта Streamable HTTP. Первое — для локального тестирования с помощью основных средств Функций Azure. Второй — для приложения-функции, размещенного в 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