powergentic/azd-mcp-ts

powergentic/azd-mcp-ts

一个 azd 模板，可使用 SSE Transport 将以 TypeScript 编写的 Model Context Protocol (MCP) 服务部署到 Azure Container Apps。

先决条件

要部署此模板，需要安装以下内容：

• Azure Developer CLI
• Docker

部署

要使用此模板，请按照以下步骤操作，并使用 Azure Developer CLI：

1. 登录 Azure Developer CLI。每次安装只需执行一次。

   azd auth login
   

2. 使用 azd init 初始化此模板：

   azd init --template powergentic/azd-mcp-ts
   

3. 确保 Docker Engine 在计算机上运行。azd 需要使用它来构建应用的 Docker 镜像，然后才能将应用部署到 Azure Container Apps。

4. 使用 azd up 配置 Azure 基础设施，并将 Web 应用部署到 Azure。

   azd up
   

5. 模板完成所有资源的配置，并且 Azure Container Apps 完成应用容器的部署后（azd up 完成后还需要大约一分钟才能完成），MCP 服务就会运行。

   

6. 要验证 MCP 服务是否正在运行，请在浏览器中访问应用的 /sse URL。

   示例 URL：

   https://ca-mcp-vnv7lqmg46722.bravebeach-29a82758.eastus2.azurecontainerapps.io/sse
   

   浏览器中会显示类似以下内容的流式输出：

   

7. 恭喜，你现在已经在 Azure 上运行一个以 TypeScript 编写的简单 MCP 服务！现在可以自定义此应用，构建 AI 解决方案所需的特定 MCP 服务。

架构图

除了部署用于托管 MCP 服务的 Azure 资源外，此模板还包含一个 DOCKERFILE，用于构建以 TypeScript 编写的 MCP 服务应用。

Azure 资源

此模板会部署以下 Azure 资源：

• Container Apps Environment - 用于托管 Container App 的环境
• Container App - 用于托管 MCP 服务应用
• Log Analytics 和 Application Insights - 用于记录 Container Apps Environment 的日志
• Container Registry - 用于部署应用的自定义 Docker 容器

资源链接

以下资源链接有助于了解如何使用 TypeScript 构建自定义 MCP 服务，以及 MCP 和 SSE 的相关知识：

• 如何使用 TypeScript 和 Azure Developer CLI (azd)，通过 Azure Container Apps 和 Docker 构建并部署 MCP 服务，作者：Chris Pietschmann

作者

此 azd 模板由 Chris Pietschmann 编写。他是 Powergentic.ai 的创始人、Microsoft MVP、HashiCorp Ambassador 和 Microsoft Certified Trainer (MCT)。