JinDaGe - cosmosdb-mcp MCP Details

article

README

🚀 Azure Cosmos DB 入门指南

本指南将帮助你快速上手 Azure Cosmos DB，介绍环境准备、快速入门步骤、操作指南以及相关参考资源，助你顺利使用 Azure Cosmos DB 进行开发。

🚀 快速开始

要使用 Azure Cosmos DB，需要完成环境准备和资源创建等步骤，以下是详细流程。

📦 安装指南

安装必要的工具

Node.js 和 npm：确保安装了 Node.js 和 npm（版本 14 或更高），你可以从 Node.js 官网下载。
.NET SDK：安装 .NET SDK，用于构建和运行 ASP.NET Core 应用程序，可从微软官网下载。
Azure CLI：安装 Azure CLI，用于与 Azure 服务交互，可从 Azure 官网下载。

创建 Azure 账户

如果你还没有 Azure 账户，请先注册一个免费的试用账户：Azure 免费试用

💻 使用示例

创建资源组和存储帐户

登录到 Azure 门户。
在左侧菜单中选择 “创建资源组”，输入名称并创建新的资源组。
在资源组中，选择 “创建存储帐户”，按照向导配置存储帐户的参数（如名称、区域等）。

配置 Cosmos DB

在 Azure 门户中，选择 “创建数据库服务” 并选择 “Cosmos DB for NoSQL”。
输入必要的信息（如名称、资源组、位置），然后完成创建。

下载并配置代码示例

基础用法

# 克隆提供的代码仓库
git clone <repository-url>

在项目根目录中，复制 .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

🔧 操作指南

数据填充

修改 appsettings.json 文件，替换占位符为实际值：

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

在终端中运行以下命令以填充产品目录：

cd populate
az login
dotnet run

实验步骤

启动服务

# 启动 MCP 服务器
cd mcp-server
npx ts-node src/server.ts

# 启动前端项目（storefront）
cd nextjs
npm start

演示步骤

打开浏览器，访问 http://localhost:3002。
点击右上角的 “AI 助手” 图标。
输入 "I'm interested in backpacks"（产品列表将刷新为背包列表）。
输入 "Get my orders"（订单列表将刷新显示订单信息）。

cosmosdb-mcp