powergentic/azd-mcp-ts

powergentic/azd-mcp-ts

SSE トランスポートを使用して、TypeScript で記述された Model Context Protocol (MCP) サーバーを Azure Container Apps にデプロイするための azd テンプレートです。

前提条件

このテンプレートをデプロイするには、以下がインストールされている必要があります。

• 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 が実行されていることを確認します。Azure Container Apps にデプロイする前に、アプリの Docker イメージをビルドするために azd が使用します。

4. azd up を使って Azure インフラストラクチャをプロビジョニングし、Web アプリケーションを Azure にデプロイします。

   azd up
   

5. テンプレートによるすべてのリソースのプロビジョニングが完了し、Azure Container Apps によるアプリコンテナーのデプロイが完了すると（azd up の完了後、さらに 1 分ほどかかる場合があります）、MCP サーバーが稼働します。

   

6. MCP サーバーが稼働していることを確認するには、ブラウザーでアプリの /sse URL にアクセスします。

   URL の例：

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

   ブラウザーにストリーミング出力が表示されます。次のような内容です。

   

7. おめでとうございます。これで、TypeScript で記述されたシンプルな MCP サーバーが Azure で稼働しました。このアプリをカスタマイズして、AI ソリューションに必要な独自の MCP サーバーを構築できます。

アーキテクチャ図

MCP サーバーをホストする Azure リソースのデプロイに加えて、このテンプレートには、TypeScript で MCP サーバーアプリをビルドする DOCKERFILE が含まれています。

Azure リソース

このテンプレートでデプロイされる Azure リソースは次のとおりです。

• Container Apps Environment - Container App をホストする環境
• Container App - MCP サーバーアプリのホスティング
• Log Analytics と Application Insights - Container Apps Environment のログ記録
• Container Registry - アプリ用のカスタム Docker コンテナーのデプロイに使用

リソースリンク

TypeScript でのカスタム MCP サーバーの構築や、MCP と SSE の概要について説明する追加のリソースリンクを紹介します。

• Azure Container Apps と Docker を使用して、Azure Developer CLI (azd) で TypeScript の MCP サーバーを構築およびデプロイする方法 — Chris Pietschmann 著

作成者

この azd テンプレートは、Powergentic.ai の創設者であり、Microsoft MVP、HashiCorp Ambassador、Microsoft Certified Trainer (MCT) でもある Chris Pietschmann が作成しました。