Aspire.MCP.Sample

Aspire.MCP.Sample

Aspire を使用した MCP サーバーと MCP クライアントのサンプルです。

概要

このサンプルでは、Aspire を使用した Model Context Protocol（MCP）サーバーとクライアントの構成を紹介します。構造化された Aspire 環境で C# を使用し、MCP 通信を確立および管理する方法を示します。

クイックデモ

プロジェクトの動作を紹介する 5 分間の動画をご覧ください。

ソリューションを Azure にデプロイする方法と、Visual Studio Code から Azure にデプロイされた MCP サーバーを利用する方法を紹介する 5 分間の動画をご覧ください。

機能

• Aspire との統合： コンテナー化されたオーケストレーションとサービス管理に Aspire を使用します。
• MCP サーバー： クライアントとの通信を管理する MCP サーバーを実装します。
• MCP クライアント： MCP サーバーへの接続と通信の方法を示す Blazor チャットクライアントのサンプルです。
• モデルの選択： チャットクライアントでは、Azure AI Foundry、Ollama、または GitHub Models の LLM を使用できます。MCP サーバーの関数を呼び出すには、選択したモデルが関数呼び出しに対応している必要があります。
• 関数呼び出し： 選択したモデルを使用して MCP サーバーの関数を呼び出す方法を示します。
• ツールの結果： 関数呼び出しの結果をチャットインターフェイスに表示します。
• Azure へのデプロイ： azd コマンドを使用して、プロジェクトを簡単に Azure にデプロイできます。

はじめに

前提条件

• .NET SDK 9.0 以降
• Visual Studio 2022 または Visual Studio code
• 関数呼び出しに対応した LLM または SLM。
  • クラウドでモデルを実行するには、Azure AI Foundry を使用します。例：gpt-4o-mini
  • クラウドでモデルを実行するには、GitHub Models を使用します。例：gpt-4o-mini
  • ローカルモデルの実行には Ollama を使用します。推奨：phi4-mini、llama3.2、または Qwq

ローカルで実行する

1. リポジトリをクローンします。

2. Aspire プロジェクトのディレクトリに移動します。

   cd .\src\McpSample.AppHost\
   

3. プロジェクトを実行します。

   dotnet run
   

4. Aspire ダッシュボードで、Blazor チャットクライアントのプロジェクトに移動します。

   

5. チャット設定ページで、使用するモデルを指定します。Azure AI Foundry（推奨：gpt-4o-mini）、GitHub Models、または Ollama を使用したローカルモデル（推奨：llama3.2）を選択できます。

   

6. これでモデルとチャットできます。MCP サーバーの関数が呼び出されるたびに、Tool Result セクションがチャットに表示されます。

   

アーキテクチャ図

GitHub Codespaces

（作業中）

• Codespaces の構成は近日中に追加されます。

デプロイ

Codespaces またはローカル環境でプロジェクトを開いたら、Azure にデプロイできます。

ターミナルウィンドウから、このリポジトリをクローンしたフォルダーを開き、次のコマンドを実行します。

1. Azure にログインします。

   azd auth login
   

2. すべてのリソースをプロビジョニングしてデプロイします。

   azd up
   

   azd 環境名（「aspiremcp」など）の入力を求められます。Azure アカウントのサブスクリプションと場所を選択してください。

3. azd によるデプロイが完了すると、Azure に作成されたリソースの一覧と、コマンド出力に一連の URI が表示されます。

4. blazorchat の URI にアクセスすると、MCP Chat App が表示されます！🎉

注： デプロイファイルは ./src/McpSample.AppHost/infra/ フォルダーにあります。これらは Aspire AppHost プロジェクトによって生成されます。

コントリビュート

コントリビュートを歓迎します！お気軽に Issue やプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。