使用说明
使用Azure函数（.NET/C#）开始使用远程MCP服务器
这是一个快速入门模板，可以使用Azure函数轻松构建自定义远程MCP服务器并将其部署到云端。您可以通过调试在本地计算机上克隆/还原/运行，以及 azd up 几分钟后就可以把它放在云端了。MCP服务器通过使用密钥和HTTPs的设计进行保护，并允许使用EasyAuth和/或API管理的OAuth以及使用VNET的网络隔离有更多选项。
观看视频概述
如果您正在寻找更多语言的此示例，请查看 Node.js/TypeScript 和 python 样品。
先决条件
- .NET 8 SDK
- Azure功能核心工具 >=
4.0.7030 - Azure开发者命令行界面
- 要使用Visual Studio在本地运行和调试，请执行以下操作：
- Visual Studio 2022.
- 确保选择 Azure开发 安装期间的工作量。
- 要使用Visual Studio代码在本地运行和调试，请执行以下操作：
以下是使用Azure Functions的远程MCP服务器的架构图：
准备好当地环境
此特定示例需要Azure存储模拟器，因为我们将从blob存储中保存和获取代码段。
-
开始Azurite
docker run -p 10000:10000 -p 10001:10001 -p 10002:10002 \ mcr.microsoft.com/azure-storage/azurite
备注 如果你使用来自VS Code扩展的Azurite，你需要运行
Azurite: Start现在，否则你会看到错误。
从终端本地运行MCP服务器
-
从
src文件夹中，运行此命令以在本地启动Functions主机：cd src func start
注意，默认情况下，这将使用webhooks路由： /runtime/webhooks/mcp/sse稍后，我们将在Azure中使用它来设置客户端/主机调用的密钥： /runtime/webhooks/mcp/sse?code=<system_key>
连接到 本地 客户端/主机内的MCP服务器
VS代码-副本编辑
-
添加MCP服务器 从命令面板中，将URL添加到正在运行的Function应用程序的SSE端点：
http://0.0.0.0:7071/runtime/webhooks/mcp/sse -
列出MCP服务器 从命令面板启动服务器
-
在Copilot聊天代理模式下，输入提示以触发工具，例如，选择一些代码并输入此提示
Say HelloSave this snippet as snippet1Retrieve snippet1 and apply to NewFile.cs -
当系统提示运行该工具时，点击同意 继续
-
完成后，在终端窗口中按Ctrl+C停止
func.exe主机进程。
MCP检查员
-
在一个 新终端窗口，安装并运行MCP检查器
npx @modelcontextprotocol/inspector node build/index.js -
按CTRL键单击可从应用程序显示的URL加载MCP Inspector web应用程序（例如。http://0.0.0.0:5173/#resources)
-
将运输类型设置为
SSE -
将URL设置为正在运行的Function应用程序的SSE端点，然后 连接:
http://0.0.0.0:7071/runtime/webhooks/mcp/sse -
列出工具。单击工具，然后 运行工具.
部署到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://<funcappname>.azurewebsites.net/runtime/webhooks/mcp/sse默认情况下，托管功能需要一个系统密钥，可以从 门户 或CLI(az functionapp keys list --resource-group <resource_group> --name <function_app_name>).获取名为的系统密钥 mcp_extension.
在MCP Inspector中连接到远程MCP服务器
对于MCP检查器，您可以在URL中包含密钥：
https://<funcappname>.azurewebsites.net/runtime/webhooks/mcp/sse?code=<your-mcp-extension-system-key>
在VS Code中连接到远程MCP服务器-GitHub Copilot
对于VS Code中的GitHub Copilot，您应该将密钥设置为 x-functions-key 标题在 mcp.json，你只需使用 https://<funcappname>.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工作
