返回 MCP 目录
public公开dns本地运行

Azure API Management Gateway with Entra ID Authentication

使用Azure API Management作为AI网关,通过Azure Functions实现远程MCP服务器的安全访问,遵循最新的MCP授权规范。

article

README

🚀 使用 Azure API Management 实现远程 MCP 服务器(实验性)

本项目借助 Azure API Management 作为 AI 网关 为 MCP 服务器提供服务,实现了最新的 MCP 授权规范,并提供了 序列图 辅助理解流程。

流程图

🚀 快速开始

📦 安装指南

将远程 MCP 服务器部署到 Azure

  1. 注册 Microsoft.App 资源提供程序:
    • 若使用 Azure CLI,运行命令 az provider register --namespace Microsoft.App --wait
    • 若使用 Azure PowerShell,先运行 Register-AzResourceProvider -ProviderNamespace Microsoft.App,再运行 (Get-AzResourceProvider -ProviderNamespace Microsoft.App).RegistrationState 检查注册是否完成。
  2. 运行以下 azd 命令,配置 api 管理服务、函数应用(含代码)以及其他所有所需的 Azure 资源:
azd up

MCP 检查工具

  1. 在新的终端窗口中,安装并运行 MCP 检查工具:
npx @modelcontextprotocol/inspector
  1. 按下 CTRL 键并单击命令行输出的 URL 以加载 MCP 检查工具(例如 http://127.0.0.1:6274/#resources)。
  2. 设置传输类型为 SSE
  3. 将 URL 设置为正在运行的 API 管理 SSE 终端点,并连接:
https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse
  1. 列出工具,点击一个工具并运行工具
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端