Back to MCP directory
publicPublicdnsLocal runtime

azd-mcp-ts

一个使用TypeScript编写的MCP服务器模板,通过Azure开发者CLI部署到Azure容器应用,支持SSE传输协议。

article

README

🚀 powergentic/azd - mcp - ts

这是一个使用 TypeScript 编写的 模型上下文协议 (MCP) 服务器的 azd 模板,可部署到 Azure 容器应用中,并采用 SSE 进行数据传输。此模板能帮助开发者快速搭建并部署 MCP 服务器。

🚀 快速开始

先决条件

要部署此模板,您需要安装以下工具:

部署步骤

使用 Azure 开发者 CLI 按照以下步骤部署此模板:

  1. 登录到 Azure 开发者 CLI。这是每次安装后的必要操作。
    azd auth login
    
  2. 初始化此模板,使用 azd init 命令:
    azd init --template powergentic/azd-mcp-ts
    
  3. 确保 Docker 引擎在您的机器上正在运行。这是 azd 打包应用镜像并部署到 Azure 容器应用所需的工具。
  4. 使用 azd up 命令来配置 Azure 基础设施并部署 Web 应用到 Azure:
    azd up
    
  5. 当模板完成所有资源的 provisioning,并且 Azure 容器应用完成对 app 容器的部署后(在 azd up 完成后,可能需要几分钟时间来完成),MCP 服务器将开始运行。 AZD UP 成功完成的截图
  6. 验证 MCP 服务器是否运行。在浏览器中导航到应用的 /sse URL。 示例 URL:
    https://ca-mcp-vnv7lqmg46722.bravebeach-29a82758.eastus2.azurecontainerapps.io/sse
    
    这将打开一个流式输出页面,显示类似以下内容的界面: MCP 服务器 /sse 端点截图
  7. 恭喜!您现在已经在 Azure 上成功运行了一个简单的 MCP 服务器。您可以根据需要自定义此应用,构建适合 AI 解决方案的专用 MCP 服务器。

✨ 主要特性

  • 采用 TypeScript 编写,提供类型检查和更好的代码可维护性。
  • 基于 模型上下文协议 (MCP),适用于 AI 相关解决方案。
  • 可部署到 Azure 容器应用,借助 Azure 的强大功能和稳定性。
  • 使用 SSE 进行数据传输,实现流式数据交互。

📚 详细文档

架构图

由该模板部署的 Azure 资源架构图 除了部署用于托管 MCP 服务器的 Azure 资源外,此模板还包括一个 DOCKERFILE,用于打包 TypeScript 编写的 MCP 服务器应用。

Azure 资源说明

以下资源将与该模板一起部署: | 属性 | 详情 | |------|------| | 容器应用环境 | 托管容器应用的环境 | | 容器应用 | 托管 MCP 服务器应用的容器实例 | | 日志分析器和应用程序见解 | 提供容器应用环境的日志记录服务 | | 容器 registry | 用于部署自定义 Docker 容器 |

资源链接

以下是一些额外的资源链接,帮助您了解构建和部署 TypeScript 的 MCP 服务器以及相关主题:

📄 许可证

暂未提及相关许可证信息。

👨‍💻 作者

azd 模板由 Chris Pietschmann 编写,他是 Powergentic.ai 的创始人,微软 MVP、HashiCorp 资深布道师和微软认证讲师 (MCT)。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client