Ipcc MCP Server Demo

使用Azure函数（.NET/C#）开始使用远程MCP服务器

这是一个快速入门模板，可以使用Azure函数轻松构建自定义远程MCP服务器并将其部署到云端。您可以通过调试在本地计算机上克隆/还原/运行，以及 azd up 几分钟后就可以把它放在云端了。MCP服务器通过使用密钥和HTTPs的设计进行保护，并允许使用EasyAuth和/或API管理的OAuth以及使用VNET的网络隔离有更多选项。

观看视频概述

如果您正在寻找更多语言的此示例，请查看 和 python 样品。

先决条件

• .NET 8 SDK
• Azure功能核心工具 >= 4.0.7030
• Azure开发者命令行界面
• 要使用Visual Studio在本地运行和调试，请执行以下操作：

- Visual Studio 2022. - 确保选择 Azure开发 安装期间的工作量。

• 要使用Visual Studio代码在本地运行和调试，请执行以下操作：

- Visual Studio Code - Azure功能扩展

以下是使用Azure Functions的远程MCP服务器的架构图：

准备好当地环境

此特定示例需要Azure存储模拟器，因为我们将从blob存储中保存和获取代码段。

1. 开始Azurite

   docker run -p 10000:10000 -p 10001:10001 -p 10002:10002 \
       mcr.microsoft.com/azure-storage/azurite

备注 如果你使用来自VS Code扩展的Azurite，你需要运行 Azurite: Start 现在，否则你会看到错误。

从终端本地运行MCP服务器

1. 从 src 文件夹中，运行此命令以在本地启动Functions主机：

   cd src
   func start

注意，默认情况下，这将使用webhooks路由： /runtime/webhooks/mcp/sse稍后，我们将在Azure中使用它来设置客户端/主机调用的密钥： /runtime/webhooks/mcp/sse?code=

连接到 *本地* 客户端/主机内的MCP服务器

VS代码-副本编辑

1. 添加MCP服务器 从命令面板中，将URL添加到正在运行的Function应用程序的SSE端点：

   http://0.0.0.0:7071/runtime/webhooks/mcp/sse

1. 列出MCP服务器 从命令面板启动服务器

1. 在Copilot聊天代理模式下，输入提示以触发工具，例如，选择一些代码并输入此提示

   Say Hello 

   Save this snippet as snippet1 

   Retrieve snippet1 and apply to NewFile.cs

1. 当系统提示运行该工具时，点击同意 继续

1. 完成后，在终端窗口中按Ctrl+C停止 func.exe 主机进程。

MCP检查员

1. 在一个 新终端窗口，安装并运行MCP检查器

   npx @modelcontextprotocol/inspector node build/index.js

1. 按CTRL键单击可从应用程序显示的URL加载MCP Inspector web应用程序（例如。http://0.0.0.0:5173/#resources)

1. 将运输类型设置为 SSE

1. 将URL设置为正在运行的Function应用程序的SSE端点，然后 连接:

   http://0.0.0.0:7071/runtime/webhooks/mcp/sse

1. 列出工具。单击工具，然后 运行工具.

部署到Azure以实现远程MCP

运行这个 azd 命令为功能应用程序配置任何所需的Azure资源，并部署您的代码：

azd up

您可以选择加入示例中使用的ExpressRoute。为此，请先执行此操作 azd up

azd env set VNET_ENABLED true

另外， API管理 可用于提高MCP服务器的安全性和策略，以及 App Service内置身份验证 可用于设置您最喜欢的OAuth提供程序，包括Entra。

从客户端连接到您的\*remote（）MCP服务器功能应用程序

您的客户端将需要一个密钥来调用新的托管SSE端点，其格式为 https://.azurewebsites.net/runtime/webhooks/mcp/sse默认情况下，托管功能需要一个系统密钥，可以从 门户 或CLI(az functionapp keys list --resource-group --name ).获取名为的系统密钥 mcp_extension.

在MCP Inspector中连接到远程MCP服务器

对于MCP检查器，您可以在URL中包含密钥：

https://.azurewebsites.net/runtime/webhooks/mcp/sse?code=

在VS Code中连接到远程MCP服务器-GitHub Copilot

对于VS Code中的GitHub Copilot，您应该将密钥设置为 x-functions-key 标题在 mcp.json，你只需使用 https://.azurewebsites.net/runtime/webhooks/mcp/sse 以下示例使用输入，并在从VS Code启动服务器时提示您提供密钥。备注 mcp.json 已包含在此仓库中，并将由VS Code获取。单击服务器上的“开始”，系统将提示输入以下值 functionapp-name （在您的/.alue/\*/env文件中）和 functions-mcp-extension-system-key 可以从上面的CLI命令或Function App门户中的API密钥中获取。

{
    "inputs": [
        {
            "type": "promptString",
            "id": "functions-mcp-extension-system-key",
            "description": "Azure Functions MCP Extension System Key",
            "password": true
        },
        {
            "type": "promptString",
            "id": "functionapp-name",
            "description": "Azure Functions App Name"
        }
    ],
    "servers": {
        "remote-mcp-function": {
            "type": "sse",
            "url": "https://${input:functionapp-name}.azurewebsites.net/runtime/webhooks/mcp/sse",
            "headers": {
                "x-functions-key": "${input:functions-mcp-extension-system-key}"
            }
        },
        "local-mcp-function": {
            "type": "sse",
            "url": "http://0.0.0.0:7071/runtime/webhooks/mcp/sse"
        }
    }
}

单击服务器上的“开始”，系统将提示输入以下值 functionapp-name （在您的/.alue/\*/env文件中）和 functions-mcp-extension-system-key 可以从上面的CLI命令或Function App门户中的API密钥中获取。

重新部署代码

你可以运行 azd up 根据需要多次执行命令，以配置Azure资源并将代码更新部署到功能应用程序。

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

清理资源

使用完功能应用程序和相关资源后，您可以使用此命令从Azure中删除功能应用程序及其相关资源，从而避免产生任何进一步的成本：

azd down

源代码

的功能代码 GetSnippet 和 SaveSnippet 端点在中定义 SnippetsTool.csThe McpToolsTrigger 应用于异步的属性 Run 该方法将代码函数作为MCP服务器公开。

这显示了一些MCP服务器示例的代码（获取字符串、获取对象、保存对象）：

[Function(nameof(SayHello))]
public string SayHello(
    [McpToolTrigger(HelloToolName, HelloToolDescription)] ToolInvocationContext context
)
{
    logger.LogInformation("Saying hello");
    return "Hello I am MCP Tool!";
}

[Function(nameof(GetSnippet))]
public object GetSnippet(
    [McpToolTrigger(GetSnippetToolName, GetSnippetToolDescription)] ToolInvocationContext context,
    [BlobInput(BlobPath)] string snippetContent)
{
    return snippetContent;
}

[Function(nameof(SaveSnippet))]
[BlobOutput(BlobPath)]
public string SaveSnippet(
    [McpToolTrigger(SaveSnippetToolName, SaveSnippetToolDescription)] ToolInvocationContext context,
    [McpToolProperty(SnippetNamePropertyName, PropertyType, SnippetNamePropertyDescription)] string name,
    [McpToolProperty(SnippetPropertyName, PropertyType, SnippetPropertyDescription)] string snippet)
{
    return snippet;
}

后续步骤

• 添加 API管理 到您的MCP服务器
• 添加 EasyAuth 到您的MCP服务器
• 使用VNET_ENABLED=true标志启用VNET
• 更多了解 微软的相关MCP工作