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

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

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

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)"
    }
}

Параметры файла 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. Если клиент не требует его специально, используйте вместо него транспорт STREAMable 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
• Создание сервера приложений MCP с помощью Функций Azure
• Настройка встроенной авторизации сервера MCP