\
使用Azure函数（Python）开始使用远程MCP服务器
这是一个快速入门模板，可以使用Azure Functions和Python轻松构建自定义远程MCP服务器并将其部署到云端。您可以通过调试在本地计算机上克隆/还原/运行，以及 azd up 几分钟后就可以把它放在云端了。MCP服务器通过使用密钥和HTTPS进行设计来保护，并允许使用内置身份验证和/或 API管理 以及使用VNET进行网络隔离。
如果您正在寻找更多语言的此示例，请查看 .NET/C# 和 版本。
](https://codespaces.new/Azure-Samples/remote-mcp-functions-python)
以下是使用Azure Functions的远程MCP服务器的架构图：
先决条件
- python 3.11或更高版本
- Azure功能核心工具 >=
4.0.7030 - Azure开发者命令行界面
- 要使用Visual Studio代码在本地运行和调试，请执行以下操作：
- Visual Studio Code - Azure功能扩展
准备好当地环境
此特定示例需要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文件夹：
cd src- 安装Python依赖项：
pip install -r requirements.txt备注 在执行以下操作之前创建虚拟环境是一种最佳做法 pip install 以避免依赖关系问题/冲突，或者如果您在CodeSpaces中运行。看 VS代码中的Python环境 了解更多信息。- 在本地启动Functions主机：
func start备注 默认情况下，这将使用webhooks路由：/runtime/webhooks/mcp/sse稍后，我们将在Azure中使用它来设置客户端/主机调用的密钥：/runtime/webhooks/mcp/sse?code=
连接到 _本地_ 来自客户端/主机的MCP服务器
VS代码-副驾驶代理模式
- 添加MCP服务器 从命令面板中，将URL添加到正在运行的Function应用程序的SSE端点：
http://0.0.0.0:7071/runtime/webhooks/mcp/sse- 列出MCP服务器 从命令面板启动服务器
- 在Copilot聊天代理模式下，输入提示以触发工具，例如，输入以下提示：
Say Hello List all available occupations Get job codes for rank S1 in NavComm Get all duty areas for occupation NavComm- 当系统提示运行该工具时，点击同意 继续
- 完成后，在终端窗口中按Ctrl+C停止Functions主机进程。
MCP检查员
- 在一个 新终端窗口，安装并运行MCP检查器
npx @modelcontextprotocol/inspector- 按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备注 此步骤在CodeSpaces中不起作用。请继续部署到远程MCP。
- 列出工具。单击工具，然后 运行工具.
部署到Azure以实现远程MCP
运行这个 雅匝德 命令为功能应用程序配置任何所需的Azure资源，并部署您的代码：
azd up您可以选择加入示例中使用的ExpressRoute。为此，请先执行此操作 azd up
azd env set VNET_ENABLED true另外， API管理 可用于提高MCP服务器的安全性和策略，以及 App Service内置身份验证 可用于设置您最喜欢的OAuth提供程序，包括Entra。
连接到您的 _远程_ 来自客户端的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"
}
}
}对于MCP检查器，您可以在URL中包含密钥： https://.azurewebsites.net/runtime/webhooks/mcp/sse?code=.
对于VS Code中的GitHub Copilot，您应该将密钥设置为 x-functions-key 标题在 mcp.json，你只需使用 https://.azurewebsites.net/runtime/webhooks/mcp/sse 以下示例使用输入，当您从VS Code启动服务器时，将提示您提供密钥：
{
"inputs": [
{
"type": "promptString",
"id": "functions-mcp-extension-system-key",
"description": "Azure Functions MCP Extension System Key",
"password": true
}
],
"servers": {
"my-mcp-server": {
"type": "sse",
"url": ".azurewebsites.net/runtime/webhooks/mcp/sse",
"headers": {
"x-functions-key": "${input:functions-mcp-extension-system-key}"
}
}
}
}重新部署代码
你可以运行 azd up 根据需要多次执行命令，以配置Azure资源并将代码更新部署到功能应用程序。
\[！注意\] 部署的代码文件总是被最新的部署包覆盖。
清理资源
使用完功能应用程序和相关资源后，您可以使用此命令从Azure中删除功能应用程序及其相关资源，从而避免产生任何进一步的成本：
azd down有用的Azure命令
部署应用程序后，您可以使用以下命令来管理和监视应用程序：
# Get your function app name from the environment file
FUNCTION_APP_NAME=$(cat .azure/$(cat .azure/config.json | jq -r '.defaultEnvironment')/env.json | jq -r '.FUNCTION_APP_NAME')
echo $FUNCTION_APP_NAME
# Get resource group
RESOURCE_GROUP=$(cat .azure/$(cat .azure/config.json | jq -r '.defaultEnvironment')/env.json | jq -r '.AZURE_RESOURCE_GROUP')
echo $RESOURCE_GROUP
# View function app logs
az webapp log tail --name $FUNCTION_APP_NAME --resource-group $RESOURCE_GROUP
# Redeploy the application without provisioning new resources
azd deploy源代码
MCP服务器提供以下工具：
代码段工具
| 工具 | 说明 |
|---|---|
hello_mcp | 一个简单的hello world工具 |
get_snippet | 从Azure Blob存储中按名称检索代码段 |
save_snippet | 将带有名称的代码段保存到Azure Blob存储 |
职业数据工具
这些工具查询存储在Azure Blob存储中的JSON文件形式的职业数据：
| 工具 | 说明 | 参数 |
|---|---|---|
list_all_occupations | 列出所有可用的职业 | 无 |
get_available_occupations | 获取职业数据（全部或特定） | occupation （可选） |
get_all_ranks | 获取职业数据中的所有独特排名 | occupation （可选） |
get_job_codes_for_rank | 获取特定职级的职位代码 | rank （必填）， occupation （可选） |
get_tasks_for_job_code | 获取特定作业代码的任务 | job_code （必填）， occupation （可选） |
get_tasks_for_duty_area | 获取特定职责范围的任务 | duty_area_code （必填）， job_code （可选）， occupation （可选） |
get_skills_for_job_code | 获取特定工作代码的技能 | job_code （必填）， occupation （可选） |
get_knowledge_for_job_code | 获取工作代码的知识项 | job_code （必填）， occupation （可选） |
get_all_duty_areas | 获取所有独特的职责范围 | occupation （可选） |
职业工具提示示例
List all available occupationsGet all ranks for NavComm occupationGet job codes for rank S1 in NavCommGet tasks for job code 514157 in NavCommGet all duty areas for NavComm函数代码在Python文件中定义 src 目录。MCP函数注释将这些函数作为MCP服务器工具公开。
请注意 host.json 文件还包括对实验包的引用，这是使用此功能的应用程序所必需的：
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Experimental",
"version": "[4.*, 5.0.0)"
}后续步骤
- 添加 API管理 到您的MCP服务器（身份验证、网关、策略等！）
- 添加 内置身份验证 到您的MCP服务器
- 使用VNET_ENABLED=true标志启用VNET
- 更多了解 微软的相关MCP工作