Cosmosdb MCP

🚀 Azure Cosmos DB 入門ガイド

このガイドでは、Azure Cosmos DB を使用するための環境構築からアプリケーションの実行までの手順を説明します。

🚀 クイックスタート

環境準備

必要なツールのインストール

1. Node.js と npm
   Node.js と npm（バージョン 14 以上）をインストールしてください。Node.js 公式サイト からダウンロードできます。

2. .NET SDK
   ASP.NET Core アプリケーションを構築および実行するために、.NET SDK をインストールします。Microsoft 公式サイト からダウンロードできます。

3. Azure CLI
   Azure サービスとのやり取りに使用する Azure CLI をインストールします。Azure 公式サイト からダウンロードできます。

Azure アカウントの作成

Azure アカウントを持っていない場合は、無料の試用アカウントを登録してください：Azure 無料試用版

リソースグループとストレージアカウントの作成

1. Azure ポータル にログインします。
2. 左側のメニューで 「リソースグループを作成」 を選択し、名前を入力して新しいリソースグループを作成します。
3. リソースグループ内で、「ストレージアカウントを作成」 を選択し、ウィザードに従ってストレージアカウントのパラメーター（名前、リージョンなど）を構成します。

Cosmos DB の構成

1. Azure ポータルで、「データベース サービスを作成」 を選択し、「Cosmos DB for NoSQL」 を選択します。
2. 必要な情報（名前、リソースグループ、場所など）を入力し、作成を完了します。

コードサンプルのダウンロードと構成

1. 提供されたコードリポジトリをクローンします：

   git clone <repository-url>
   

2. プロジェクトのルート ディレクトリで、.env.template ファイルを .env にコピーし、実際の状況に合わせて構成を変更します：

{
  "CosmosDb": {
    "Endpoint": "https://<cosmosdb_account_name>.documents.azure.com:443/",
    "TenantId": "<tenant_id>",
    "DatabaseName": "eshop",
    "ProductsContainerName": "products",
    "OrdersContainerName": "orders"
  }
}

アプリケーションの実行

1. ターミナルで次のコマンドを実行して Web API をビルドします：

   cd webapi
   dotnet build
   

2. Web API を起動します：

   cd webapi
   dotnet run
   

📚 操作ガイド

データの充填

1. appsettings.json ファイルを変更し、プレースホルダーを実際の値に置き換えます：

   {
     "CosmosDb": {
       "Endpoint": "https://<cosmosdb_account_name>.documents.azure.com:443/",
       "TenantId": "<tenant_id>",
       "DatabaseName": "eshop",
       "ProductsContainerName": "products",
       "OrdersContainerName": "orders"
     }
   }
   

2. ターミナルで次のコマンドを実行して製品カタログを充填します：

   cd populate
   az login
   dotnet run
   

実験手順

サービスの起動

1. 開発用コンピューターで MCP サーバーを起動します：

   cd mcp-server
   npx ts-node src/server.ts
   

2. フロントエンド プロジェクト（storefront）を起動します：
   • NextJS フロントエンド ディレクトリで次のコマンドを実行します：

     cd nextjs
     npm start
     

デモ手順

1. ブラウザを開き、http://localhost:3002 にアクセスします。
2. 右上の 「AI アシスタント」 アイコンをクリックします。
3. "I'm interested in backpacks" を入力します（製品リストがバックパックのリストに更新されます）。
4. "Get my orders" を入力します（注文リストが注文情報を表示するように更新されます）。

参考リソース

• Azure Cosmos DB ドキュメント
• .NET 入門ガイド
• Next.js 公式ドキュメント