Cosmosdb MCP

🚀 Azure Cosmos DB 入門指南

本指南將幫助你快速上手 Azure Cosmos DB，介紹從環境準備到應用程序運行的詳細步驟，助你順利使用該服務。

🚀 快速開始

環境準備

安裝必要的工具

1. Node.js 和 npm：確保安裝了 Node.js 和 npm（版本 14 或更高），可從 Node.js 官網 下載。
2. .NET SDK：安裝 .NET SDK，用於構建和運行 ASP.NET Core 應用程序，可從 微軟官網 下載。
3. Azure CLI：安裝 Azure CLI，用於與 Azure 服務交互，可從 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"
  }
}

運行應用程序

構建 Web API

cd webapi
dotnet build

啟動 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

實驗步驟

啟動服務

• 啟動 MCP 服務器：

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

• 啟動前端項目（ storefront）：

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 官方文檔