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