Introducción a los enlaces de herramientas de MCP para Azure Functions

El Protocolo de contexto de modelo (MCP) es un protocolo de servidor cliente diseñado para permitir que los modelos de lenguaje y los agentes detecten y usen de forma más eficaz orígenes de datos externos y herramientas.

Importante

La extensión MCP de Azure Functions está actualmente en versión preliminar. Puede esperar cambios en las API de desencadenador y enlace hasta que la extensión esté disponible con carácter general.
Debe evitar el uso de extensiones de vista previa en aplicaciones de producción.

La extensión MCP de Azure Functions permite usar Azure Functions para crear servidores MCP remotos. La aplicación de funciones implementa un servidor MCP remoto exponiendo un conjunto de puntos de conexión que se implementan como funciones de desencadenador de herramientas de MCP. Los clientes MCP, como los modelos de lenguaje y los agentes, pueden consultar y acceder a estas herramientas para realizar tareas específicas, como almacenar o acceder a fragmentos de código. Los clientes mcP también pueden suscribirse a la aplicación para recibir notificaciones sobre los cambios en las herramientas expuestas.

Importante

La extensión MCP no admite actualmente aplicaciones de PowerShell.

Prerrequisitos

• El desencadenador de la herramienta MCP se basa en Azure Queue Storage proporcionado por la cuenta de almacenamiento de host predeterminada (AzureWebJobsStorage). Al usar identidades administradas, asegúrese de que la aplicación de funciones tenga al menos el equivalente de estos permisos basados en roles en la cuenta de almacenamiento de host: Lector de datos de cola de Storage y Procesador de mensajes de datos de cola de storage.
• Cuando se ejecuta localmente, la extensión MCP requiere la versión 4.0.7030 de Azure Functions Core Tools o una versión posterior.

• Requiere la versión 2.0.2 o posterior del Microsoft.Azure.Functions.Worker.Sdk paquete.

Instalación de la extensión

Sugerencia

La extensión MCP de Azure Functions solo admite el modelo de trabajo aislado.

Agregue la extensión al proyecto mediante la instalación de este paquete NuGet de la manera que prefiera:

Microsoft.Azure.Functions.Worker.Extensions.Mcp

Instalación del conjunto

La versión preliminar de la extensión MCP forma parte de una agrupación de extensiones experimentales, que se especifica en el archivo de proyecto de host.json.

Para usar este paquete experimental en la aplicación, reemplace el objeto existente extensionBundle en el archivo host.json del proyecto por este objeto JSON:

"extensionBundle": {
  "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
  "version": "[4.*, 5.0.0)"
}

configuración de host.json

En esta sección se describen las opciones de configuración disponibles para este enlace en la versión 2.x y posteriores. La configuración del archivo host.json se aplica a todas las funciones de una instancia de la aplicación de funciones. Para más información sobre las opciones de configuración de la aplicación de funciones, consulte host.json referencia para Azure Functions.

{
  "version": "2.0",
  "extensions": {
    "mcp": {
      "instructions": "Some test instructions on how to use the server",
      "serverName": "TestServer",
      "serverVersion": "2.0.0"
    }
  }
}

Propiedad	Descripción
instrucciones	Describe a los clientes cómo acceder al servidor MCP remoto.
serverName de	Nombre descriptivo para el servidor MCP remoto.
serverVersion	Versión actual del servidor MCP remoto.

Artículos relacionados

Creación de un punto de conexión de herramienta en el servidor MCP remoto