[{"_1":2,"_420":-5,"_421":-5},"loaderData",{"_3":4,"_22":23,"_313":314},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",19346472,"membership","referenceId","0199f420-7955-7299-8090-ea86aef37824","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_66":-5,"_67":26,"_27":68,"_230":231,"_312":214},"availableLocales",[26,38,45,52,59],{"_27":28,"_31":35,"_36":37},"mcpServer",{"_29":30,"_31":32,"_33":34},"description","Node.js server that connects to Azure Cosmos DB NoSQL database, allowing users to query products and orders through an AI Assistant in a NextJS frontend application.","name","Azure Cosmos DB MCP Server","readme","# Azure Cosmos DB MCP CLient & Server\n\nThis repository contains a project that shows how to create an MCP Server and client for Azure Cosmos DB. The project is divided into 2 parts:\n\n- Frontend application: NextJS 15 application that displays a products catalog and features an AI Assistant that helps users to find products in the catalog and get past orders\n- an MCP Server component, connected to the Azure Cosmos DB NoSQL database and responsible for reading products and orders from the database.\n\n\n![Demo](assets/demo.gif)\n\n## Azure Architecture\n\n- an Azure Cosmos DB NoSQL database that stores the product catalog\n- a node.js server that serves as the MCP Server component\n\n\n## References\n\n- [Create an Azure Cosmos DB for NoSQL account](https://learn.microsoft.com/en-us/azure/cosmos-db/nosql/quickstart-portal)\n- [Create an Azure Storage account](https://learn.microsoft.com/en-us/azure/storage/common/storage-account-create?tabs=azure-portal)\n- [Create a Windows virtual machine](https://learn.microsoft.com/en-us/azure/virtual-machines/windows/quick-create-portal)\n- [Windows execution policies](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/set-executionpolicy?view=powershell-7.5)\n\n## Step-by-step walkthrough\n\n### Installation\n\n**Azure Cosmos DB**\n\nIn the Azure portal, create an Azure Cosmos DB for NoSQL account.\n\n- Give a unique name for your Azure Cosmos DB account. We will be using cosmos-eastus2-nosql-2 in the rest of this walkthrough.\n\n![Cosmos DB - Basics](assets/cosmos-basics.png)\n\n- Click on \"Next: Global distribution\"\n\n![Cosmos DB - Global distribution](assets/cosmos-global-distribution.png)\n\n- Accept the default values and click on \"Next: Networking\"\n\n![Cosmos DB - Networking](assets/cosmos-networking.png)\n\n- Accept the default values and click on \"Next: Backup Policy\"\n- Select \"Periodic\" backup policy\n- Select \"Locally-redundant backup storage\"\n\n![Cosmos DB - Backup Policy](assets/cosmos-backup-policy.png)\n\n- Click on \"Next: Encryption\"\n\n![Cosmos DB - Encryption](assets/cosmos-encryption.png)\n\n- Click on \"Review and Create\" to start validation\n\n![Cosmos DB - Validation](assets/cosmos-validation.png)\n\n- Click on \"Create\" to start the creation of the Azure Cosmos DB for NoSQL account\n\nFor this project, you will need to enable vector support on the Azure Cosmos DB account.\n- In the settings section, select Features, then \"Vector Search for NoSQL API\"\n\n- In the panel that opens, click on the Enable button\n\n![Cosmos DB - Validation](assets/cosmos-enable-vector-search.png)\n\n- Create the Azure Cosmos DB eShop database and the Products container\n\n- Click on \"...\" next to eShop to display the contextual menu and select \"New container\" to create the \"carts\" container in the eShop database.\n\nMake sure that the partition key is **_\"/id\"_** (the partition key is case-sensitive)\n\nExpand \"Container Vector Policy\" and click on the \"Add vector embedding\" button\n\n![Cosmos DB - Create database](assets/cosmos-create-products.png)\n\n- Create the carts container\n\n![Cosmos DB - Create database](assets/cosmos-create-carts.png)\n\n**Storage account**\n\n1. Create a storage account to store the product images\n\nFor more details, refer to the documentation: https://learn.microsoft.com/en-us/azure/storage/common/storage-account-create?tabs=azure-portal\n\n![Storage - Basics](assets/storage-basics.png)\n\n![Storage - Advanced](assets/storage-advanced.png)\n\n![Storage - Networking](assets/storage-networking.png)\n\n![Storage - Data protection](assets/storage-data-protection.png)\n\n![Storage - Encryption](assets/storage-encryption.png)\n\n![Storage - Validation](assets/storage-validation.png)\n\n\n**Install software pre-requisites **\n\n1. Create a virtual machine in Azure or use your local computer\n2. Install node.js v22.13.1 (LTS) from https://nodejs.org/en/download\n3. Install Visual Studio Code x64 1.97.0 from https://code.visualstudio.com/download\n4. Install Git 2.47.12 x64 from https://git-scm.com/downloads\n5. Install .NET SDK x64 v9.0.102 from https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-9.0.102-windows-x64-installer\n6. Open a terminal window and add nuget source with\n\n```sh\ndotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org\n```\n\n7. If necessary, change PowerShell execution policies for Windows computers. Open a Powershell window **in administrator mode** and run this command\n\n```sh\nSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser\n```\n\n8. If necessary, install nuget, powershell, az cli and az modules\n\n```sh\n# install az cli\nwinget install -e --id Microsoft.AzureCLI\n\n# install nuget and reference nuget source\nInstall-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force\n\n# update to latest Powershell release (7.5 as of writing)\nwinget install --id Microsoft.PowerShell --source winget\n\n# install az modules\nInstall-Module -Name Az -Repository PSGallery -Force -AllowClobber\n```\n\n9. Open a terminal window and clone the repository:\n\n```sh\ngit clone https://github.com/patrice-truong/cosmosdb-mcp.git\ncd cosmosdb-mcp\n```\n\n10. Navigate to the nextjs folder and install dependencies\n\n```sh\ncd cosmosdb-mcp/nextjs\nnpm install --legacy-peer-deps\n```\n\n11. In the nextjs folder, create and configure an .env file with the following values:\n\n```sh\nAZURE_COSMOSDB_NOSQL_ENDPOINT=https://.documents.azure.com:443/\nAZURE_COSMOSDB_NOSQL_DATABASE=eshop\nAZURE_COSMOSDB_NOSQL_PRODUCTS_CONTAINER=products\nAZURE_COSMOSDB_NOSQL_CARTS_CONTAINER=carts\nAZURE_COSMOSDB_NOSQL_ORDERS_CONTAINER=orders\nAZURE_STORAGE_ACCOUNT_NAME=\nAZURE_STORAGE_CONTAINER_NAME=\n```\n\n12. Get your tenant ID. The tenant ID can be retrieved with this command:\n\n```sh\naz login\naz account show --query tenantId -o tsv\n```\n\n13. In the webapi folder, configure the appsettings.json file and replace the tenant_id with the value obtained in the previous step:\n\n```sh\n{\n \"CosmosDb\": {\n \"Endpoint\": \"https:/.documents.azure.com:443/\",\n \"TenantId\": \"\",\n \"DatabaseName\": \"eshop\",\n \"ProductsContainerName\": \"products\",\n \"CartsContainerName\": \"carts\",\n \"OrdersContainerName\": \"orders\"\n },\n \"AzureBlobStorage\": {\n \"AccountName\": \"\"\n }\n}\n```\n14. Create an app registration in the Azure Portal\n15. Create an app secret in the Azure Portal\n16. You will need to allow your app to get access to Azure Cosmos DB. Retrieve the 4 ids mentioned below and modify the file \"populate/set_rbac.ps1\".\n\n| Variable | Reference |\n| ---------------------------- | ------------------------------------------------- |\n| Subscription Id | Cosmos DB > Overview > Subscription Id |\n| Azure Cosmos DB account name | cosmos-eastus2-nosql-2 |\n| Resource group name | Cosmos DB > Overview > Resource group name |\n| Principal Id | App registration Object Id |\n\n```sh\n$SubscriptionId = \"\" # Azure subscription id\n$AccountName = \"\" # cosmos db account name\n$ResourceGroupName = \"\" # resource group name of the Cosmos DB account\n$PrincipalId = \"\" # object id of the app registered in Entra ID\n```\n\n17. Open a Powershell prompt, run Connect-AzAccount and execute ./set_rbac.ps1\n\n![Cosmos DB - RBAC](assets/cosmos-rbac.png)\n\n18. Allow your app (or virtual machine) to access the storage account\n\n- In the Azure portal, goto your storage account\n- Select Access Control (IAM) in the menu\n\n![Storage - Access Control](assets/storage-access-control.png)\n\n- Click on \"Add role assignment\"\n- In the filter textbox, type \"Storage Blob Data Contributor\"\n\n![Storage - Blob Data contributor](assets/storage-blob-data-contributor.png)\n\n- Click on \"Members\"\n- Select the name of your application\n\n![Storage - Role assignment](assets/storage-role-assignment.png)\n\n- Click on the \"Select\" button\n- Click on \"Review and assign\"\n\n![Storage - Role assignment](assets/storage-review.png)\n\n19. Create a container and copy the content of the \"azure-storage\" folder to your storage account\n\n![Storage - Create container](assets/storage-create-container.png)\n\n![Storage - Upload files](assets/storage-upload-files.png)\n\n![Storage - Files uploaded](assets/storage-files-uploaded.png)\n\n20. Build webapi backend project with dotnet build\n\n```sh\ncd webapi\ndotnet build\n```\n\n![Dotnet build](assets/dotnet_build.png) 18. On your secondary region VM (Australia East), modify the .env file with the IP address of the socket server in your primary region (East US 2)\n\n![socket_server_ip](assets/socket_server_ip.png)\n\n19. There is no authentication built into this project. The user email is hard-coded in /nextjs/models/constants.ts. Change it to suit your demo needs\n\n![npm run build](assets/constants_email.png)\n\n19. In mcp-server and nextjs folders, copy .env.template to .env and modify the values to suit your demo needs\n\n```json\nAZURE_COSMOSDB_NOSQL_ENDPOINT=https://.documents.azure.com:443/\nAZURE_COSMOSDB_NOSQL_DATABASE=eshop\nAZURE_COSMOSDB_NOSQL_PRODUCTS_CONTAINER=products\nAZURE_COSMOSDB_NOSQL_CARTS_CONTAINER=carts\nAZURE_COSMOSDB_NOSQL_ORDERS_CONTAINER=orders\n\nNEXT_PUBLIC_AZURE_TENANT_ID=\nNEXT_PUBLIC_AZURE_CLIENT_ID=\nNEXT_PUBLIC_AZURE_CLIENT_SECRET=\n\nNEXT_PUBLIC_AZURE_STORAGE_ACCOUNT_NAME=\nNEXT_PUBLIC_AZURE_STORAGE_CONTAINER_NAME=img\n\nAZURE_OPENAI_ENDPOINT=https://.openai.azure.com/\nAZURE_OPENAI_API_KEY=\nAZURE_OPENAI_EMBEDDING_MODEL=text-embedding-3-small\nAZURE_OPENAI_API_VERSION=2024-05-01-preview\n```\n\n20. Build nextjs frontend project\n\n```sh\ncd nextjs\nnpm run build\n```\n\n![npm run build](assets/npm_run_build.png)\n\n## Populate the products catalog\n\nIn this section, we'll read the products catalog from the populate/catalog.json file and populate the Azure Cosmos DB for NoSQL database\n\n1. Modify appsettings.json with your cosmosdb account name and \n\n```json\n{\n \"CosmosDb\": {\n \"Endpoint\": \"https://.documents.azure.com:443/\",\n \"TenantId\": \"\",\n \"DatabaseName\": \"eshop\",\n \"ProductsContainerName\": \"products\",\n \"OrdersContainerName\": \"orders\",\n }\n}\n```\n\n2. Open a terminal window, navigate to the populate folder, execute az login, then dotnet run\n\n![Cosmos - Populate products](assets/cosmos-populate-products.png)\n\n3. Verify that the Azure Cosmos DB container has been properly populated\n\n![Cosmos - Products](assets/cosmos-products.png)\n\n## Demo script\n\n**Demo initialization:**\n\n3. On your development computer, start the mcp server\n\n```sh\ncd mcp-server\nnpx ts-node src/server.ts\n```\n\n3. Start the front end project\n\n- NextJS front end (store front)\n - cd nextjs\n - npm start\n\n4. Optionally, open a command prompt and start the MCP inspector with this command:\nnpx -y @modelcontextprotocol/inspector\n\n\n**Demo steps:**\n\n1. Navigate to http://localhost:3002. \n2. \n2. Click on AI Assistant icon in the top right corner\n3. Enter \"I'm interested in backpacks\" (the list of product refreshes with a list of backpacks)\n4. Enter \"Get my orders\" (the list of orders refreshes with a list of orders)\n\n\n![Demo](assets/demo.gif)\n","English","tag","en-US",{"_27":39,"_31":43,"_36":44},{"_29":40,"_31":41,"_33":42},"Servidor Node.js que se conecta a la base de datos NoSQL de Azure Cosmos DB, lo que permite a los usuarios consultar productos y pedidos a través de un Asistente de IA en una aplicación frontend de NextJS.","Servidor MCP de Azure Cosmos DB","# Cliente y servidor de MCP de Azure Cosmos DB\n\nEste repositorio contiene un proyecto que muestra cómo crear un servidor y un cliente MCP para Azure Cosmos DB. El proyecto se divide en dos partes:\n\n* Aplicación frontend: Aplicación NextJS 15 que muestra un catálogo de productos y cuenta con un asistente de IA que ayuda a los usuarios a encontrar productos en el catálogo y obtener pedidos anteriores.\n* un componente de servidor MCP, conectado a la base de datos NoSQL de Azure Cosmos DB y responsable de leer productos y pedidos de la base de datos.\n\n![Manifestación](assets/demo.gif)\n\n## Arquitectura de Azure\n\n* una base de datos NoSQL de Azure Cosmos DB que almacena el catálogo de productos\n* un servidor node.js que sirve como componente de servidor MCP\n\n## Referencias\n\n* [Crear una cuenta de Azure Cosmos DB para NoSQL](https://learn.microsoft.com/en-us/azure/cosmos-db/nosql/quickstart-portal)\n* [Crear una cuenta de Azure Storage](https://learn.microsoft.com/en-us/azure/storage/common/storage-account-create?tabs=azure-portal)\n* [Crear una máquina virtual de Windows](https://learn.microsoft.com/en-us/azure/virtual-machines/windows/quick-create-portal)\n* [Políticas de ejecución de Windows](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/set-executionpolicy?view=powershell-7.5)\n\n## Tutorial paso a paso\n\n### Instalación\n\n**Azure Cosmos DB**\n\nEn el portal de Azure, cree una cuenta de Azure Cosmos DB para NoSQL.\n\n* Asigne un nombre único a su cuenta de Azure Cosmos DB. Usaremos cosmos-eastus2-nosql-2 en el resto de este tutorial.\n\n![Cosmos DB - Conceptos básicos](assets/cosmos-basics.png)\n\n* Haga clic en \"Siguiente: Distribución global\"\n\n![Cosmos DB - Distribución global](assets/cosmos-global-distribution.png)\n\n* Acepte los valores predeterminados y haga clic en \"Siguiente: Redes\".\n\n![Cosmos DB - Redes](assets/cosmos-networking.png)\n\n* Acepte los valores predeterminados y haga clic en \"Siguiente: Política de respaldo\"\n* Seleccione la política de copias de seguridad \"Periódico\"\n* Seleccione \"Almacenamiento de respaldo con redundancia local\"\n\n![Cosmos DB - Política de copias de seguridad](assets/cosmos-backup-policy.png)\n\n* Haga clic en \"Siguiente: Cifrado\"\n\n![Cosmos DB - Cifrado](assets/cosmos-encryption.png)\n\n* Haga clic en \"Revisar y crear\" para iniciar la validación.\n\n![Cosmos DB - Validación](assets/cosmos-validation.png)\n\n* Haga clic en \"Crear\" para iniciar la creación de la cuenta de Azure Cosmos DB para NoSQL\n\nPara este proyecto, deberá habilitar la compatibilidad con vectores en la cuenta de Azure Cosmos DB.\n\n* En la sección de configuración, seleccione Características y luego \"Búsqueda vectorial para API NoSQL\".\n\n* En el panel que se abre, haga clic en el botón Habilitar\n\n![Cosmos DB - Validación](assets/cosmos-enable-vector-search.png)\n\n* Cree la base de datos de Azure Cosmos DB eShop y el contenedor Productos\n\n* Haga clic en \"...\" junto a eShop para mostrar el menú contextual y seleccione \"Nuevo contenedor\" para crear el contenedor \"carritos\" en la base de datos de eShop.\n\nAsegúrese de que la clave de partición sea ***\"/id\"*** (la clave de partición distingue entre mayúsculas y minúsculas)\n\nExpanda \"Política de vectores de contenedores\" y haga clic en el botón \"Agregar incrustación de vectores\".\n\n![Cosmos DB - Crear base de datos](assets/cosmos-create-products.png)\n\n* Crear el contenedor de carritos\n\n![Cosmos DB - Crear base de datos](assets/cosmos-create-carts.png)\n\n**Cuenta de almacenamiento**\n\n1. Crea una cuenta de almacenamiento para guardar las imágenes del producto\n\nPara obtener más detalles, consulte la documentación: \n\n![Almacenamiento: conceptos básicos](assets/storage-basics.png)\n\n![Almacenamiento - Avanzado](assets/storage-advanced.png)\n\n![Almacenamiento - Redes](assets/storage-networking.png)\n\n![Almacenamiento - Protección de datos](assets/storage-data-protection.png)\n\n![Almacenamiento - Cifrado](assets/storage-encryption.png)\n\n![Almacenamiento - Validación](assets/storage-validation.png)\n\n\\*\\*Requisitos previos para la instalación del software\\*\\*\n\n1. Cree una máquina virtual en Azure o use su computadora local\n2. Instale node.js v22.13.1 (LTS) desde \n3. Instale Visual Studio Code x64 1.97.0 desde \n4. Instale Git 2.47.12 x64 desde \n5. Instale .NET SDK x64 v9.0.102 desde \n6. Abra una ventana de terminal y agregue la fuente NuGet con\n\n```sh\ndotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org\n```\n\n7. Si es necesario, modifique las políticas de ejecución de PowerShell para equipos Windows. Abra una ventana de PowerShell **en modo administrador** y ejecute este comando.\n\n```sh\nSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser\n```\n\n8. Si es necesario, instale los módulos Nuget, PowerShell, Az CLI y Az\n\n```sh\n# install az cli\nwinget install -e --id Microsoft.AzureCLI\n\n# install nuget and reference nuget source\nInstall-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force\n\n# update to latest Powershell release (7.5 as of writing)\nwinget install --id Microsoft.PowerShell --source winget\n\n# install az modules\nInstall-Module -Name Az -Repository PSGallery -Force -AllowClobber\n```\n\n9. Abra una ventana de terminal y clone el repositorio:\n\n```sh\ngit clone https://github.com/patrice-truong/cosmosdb-mcp.git\ncd cosmosdb-mcp\n```\n\n10. Navegue a la carpeta nextjs e instale las dependencias\n\n```sh\ncd cosmosdb-mcp/nextjs\nnpm install --legacy-peer-deps\n```\n\n11. En la carpeta nextjs, cree y configure un archivo .env con los siguientes valores:\n\n```sh\nAZURE_COSMOSDB_NOSQL_ENDPOINT=https://.documents.azure.com:443/\nAZURE_COSMOSDB_NOSQL_DATABASE=eshop\nAZURE_COSMOSDB_NOSQL_PRODUCTS_CONTAINER=products\nAZURE_COSMOSDB_NOSQL_CARTS_CONTAINER=carts\nAZURE_COSMOSDB_NOSQL_ORDERS_CONTAINER=orders\nAZURE_STORAGE_ACCOUNT_NAME=\nAZURE_STORAGE_CONTAINER_NAME=\n```\n\n12. Obtén tu ID de inquilino. Puedes obtenerlo con este comando:\n\n```sh\naz login\naz account show --query tenantId -o tsv\n```\n\n13. En la carpeta webapi, configure el archivo appsettings.json y reemplace el tenant\\_id con el valor obtenido en el paso anterior:\n\n```sh\n{\n \"CosmosDb\": {\n \"Endpoint\": \"https:/.documents.azure.com:443/\",\n \"TenantId\": \"\",\n \"DatabaseName\": \"eshop\",\n \"ProductsContainerName\": \"products\",\n \"CartsContainerName\": \"carts\",\n \"OrdersContainerName\": \"orders\"\n },\n \"AzureBlobStorage\": {\n \"AccountName\": \"\"\n }\n}\n```\n\n14. Crear un registro de aplicación en el Portal de Azure\n15. Crear un secreto de aplicación en el Portal de Azure\n16. Necesitará permitir que su aplicación acceda a Azure Cosmos DB. Recupere los cuatro identificadores mencionados a continuación y modifique el archivo \"populate/set\\_rbac.ps1\".\n\n| Variable | Referencia |\n| -------------------------------------- | -------------------------------------------------------------- |\n| ID de suscripción | Cosmos DB > Descripción general > Id. de suscripción |\n| Nombre de la cuenta de Azure Cosmos DB | cosmos-eastus2-nosql-2 |\n| Nombre del grupo de recursos | Cosmos DB > Descripción general > Nombre del grupo de recursos |\n| Identificación principal | Id. de objeto de registro de la aplicación |\n\n```sh\n$SubscriptionId = \"\" # Azure subscription id\n$AccountName = \"\" # cosmos db account name\n$ResourceGroupName = \"\" # resource group name of the Cosmos DB account\n$PrincipalId = \"\" # object id of the app registered in Entra ID\n```\n\n17. Abra un símbolo del sistema de PowerShell, ejecute Connect-AzAccount y ejecute ./set\\_rbac.ps1\n\n![Cosmos DB - RBAC](assets/cosmos-rbac.png)\n\n18. Permitir que su aplicación (o máquina virtual) acceda a la cuenta de almacenamiento\n\n* En el portal de Azure, vaya a su cuenta de almacenamiento\n* Seleccione Control de acceso (IAM) en el menú\n\n![Almacenamiento - Control de acceso](assets/storage-access-control.png)\n\n* Haga clic en \"Agregar asignación de rol\"\n* En el cuadro de texto del filtro, escriba \"Contribuidor de datos de blobs de almacenamiento\".\n\n![Almacenamiento - Colaborador de datos de blobs](assets/storage-blob-data-contributor.png)\n\n* Haga clic en \"Miembros\"\n* Seleccione el nombre de su aplicación\n\n![Almacenamiento - Asignación de roles](assets/storage-role-assignment.png)\n\n* Haga clic en el botón \"Seleccionar\"\n* Haga clic en \"Revisar y asignar\"\n\n![Almacenamiento - Asignación de roles](assets/storage-review.png)\n\n19. Cree un contenedor y copie el contenido de la carpeta \"azure-storage\" a su cuenta de almacenamiento\n\n![Almacenamiento - Crear contenedor](assets/storage-create-container.png)\n\n![Almacenamiento - Subir archivos](assets/storage-upload-files.png)\n\n![Almacenamiento - Archivos subidos](assets/storage-files-uploaded.png)\n\n20. Cree un proyecto backend de webapi con dotnet build\n\n```sh\ncd webapi\ndotnet build\n```\n\n![Compilación de Dotnet](assets/dotnet_build.png) 18. En la máquina virtual de su región secundaria (Australia Este), modifique el archivo .env con la dirección IP del servidor de sockets de su región principal (East US 2).\n\n![IP del servidor de sockets](assets/socket_server_ip.png)\n\n19. Este proyecto no incluye autenticación. El correo electrónico del usuario está predefinido en /nextjs/models/constants.ts. Modifíquelo para adaptarlo a las necesidades de su demostración.\n\n![npm ejecutar compilación](assets/constants_email.png)\n\n19. En las carpetas mcp-server y nextjs, copie .env.template a .env y modifique los valores para adaptarlos a sus necesidades de demostración\n\n```json\nAZURE_COSMOSDB_NOSQL_ENDPOINT=https://.documents.azure.com:443/\nAZURE_COSMOSDB_NOSQL_DATABASE=eshop\nAZURE_COSMOSDB_NOSQL_PRODUCTS_CONTAINER=products\nAZURE_COSMOSDB_NOSQL_CARTS_CONTAINER=carts\nAZURE_COSMOSDB_NOSQL_ORDERS_CONTAINER=orders\n\nNEXT_PUBLIC_AZURE_TENANT_ID=\nNEXT_PUBLIC_AZURE_CLIENT_ID=\nNEXT_PUBLIC_AZURE_CLIENT_SECRET=\n\nNEXT_PUBLIC_AZURE_STORAGE_ACCOUNT_NAME=\nNEXT_PUBLIC_AZURE_STORAGE_CONTAINER_NAME=img\n\nAZURE_OPENAI_ENDPOINT=https://.openai.azure.com/\nAZURE_OPENAI_API_KEY=\nAZURE_OPENAI_EMBEDDING_MODEL=text-embedding-3-small\nAZURE_OPENAI_API_VERSION=2024-05-01-preview\n```\n\n20. Construir un proyecto frontend de nextjs\n\n```sh\ncd nextjs\nnpm run build\n```\n\n![npm ejecutar compilación](assets/npm_run_build.png)\n\n## Completar el catálogo de productos\n\nEn esta sección, leeremos el catálogo de productos del archivo populate/catalog.json y completaremos la base de datos de Azure Cosmos DB para NoSQL.\n\n1. Modifique appsettings.json con el nombre de su cuenta cosmosdb y\n\n```json\n{\n \"CosmosDb\": {\n \"Endpoint\": \"https://.documents.azure.com:443/\",\n \"TenantId\": \"\",\n \"DatabaseName\": \"eshop\",\n \"ProductsContainerName\": \"products\",\n \"OrdersContainerName\": \"orders\",\n }\n}\n```\n\n2. Abra una ventana de terminal, navegue hasta la carpeta de población, ejecute az login y luego dotnet run\n\n![Cosmos - Rellenar productos](assets/cosmos-populate-products.png)\n\n3. Verifique que el contenedor de Azure Cosmos DB se haya rellenado correctamente\n\n![Cosmos - Productos](assets/cosmos-products.png)\n\n## Guión de demostración\n\n**Inicialización de demostración:**\n\n3. En su computadora de desarrollo, inicie el servidor mcp\n\n```sh\ncd mcp-server\nnpx ts-node src/server.ts\n```\n\n3. Iniciar el proyecto frontend\n\n* Front-end de NextJS (tienda virtual)\n * cd nextjs\n * inicio de npm\n\n4. Opcionalmente, abra un símbolo del sistema e inicie el inspector MCP con este comando: npx -y @modelcontextprotocol/inspector\n\n**Pasos de demostración:**\n\n1. Vaya a .\n2. Haga clic en el ícono del Asistente de IA en la esquina superior derecha\n3. Ingresa \"Me interesan las mochilas\" (la lista de productos se actualiza con una lista de mochilas)\n4. Ingresa a \"Obtener mis pedidos\" (la lista de pedidos se actualiza con una lista de pedidos)\n\n![Manifestación](assets/demo.gif)","Spanish","es-ES",{"_27":46,"_31":50,"_36":51},{"_29":47,"_31":48,"_33":49},"Azure Cosmos DB NoSQL データベースに接続する Node.js サーバー。ユーザーは、NextJS フロントエンドアプリケーションの AI アシスタントを通じて製品や注文を照会できます。","Azure Cosmos DB MCP サーバー","# Azure Cosmos DB MCP クライアント & サーバー\n\nこのリポジトリには、Azure Cosmos DB 用の MCP サーバーとクライアントの作成方法を示すプロジェクトが含まれています。このプロジェクトは 2 つの部分に分かれています。\n\n* フロントエンドアプリケーション: 製品カタログを表示し、ユーザーがカタログ内の製品を見つけて過去の注文を取得するのに役立つ AI アシスタントを備えた NextJS 15 アプリケーション\n* Azure Cosmos DB NoSQL データベースに接続され、データベースから製品と注文を読み取る役割を担う MCP サーバーコンポーネント。\n\n![デモ](assets/demo.gif)\n\n## Azure アーキテクチャ\n\n* 製品カタログを保存する Azure Cosmos DB NoSQL データベース\n* MCP サーバーコンポーネントとして機能する Node.js サーバー\n\n## 参考文献\n\n* [Azure Cosmos DB for NoSQL アカウントを作成する](https://learn.microsoft.com/en-us/azure/cosmos-db/nosql/quickstart-portal)\n* [Azure ストレージアカウントを作成する](https://learn.microsoft.com/en-us/azure/storage/common/storage-account-create?tabs=azure-portal)\n* [Windows仮想マシンを作成する](https://learn.microsoft.com/en-us/azure/virtual-machines/windows/quick-create-portal)\n* [Windows実行ポリシー](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/set-executionpolicy?view=powershell-7.5)\n\n## ステップバイステップのウォークスルー\n\n### インストール\n\n**Azure Cosmos DB**\n\nAzure ポータルで、Azure Cosmos DB for NoSQL アカウントを作成します。\n\n* Azure Cosmos DB アカウントに一意の名前を付けます。このチュートリアルの残りの部分では、cosmos-eastus2-nosql-2 を使用します。\n\n![Cosmos DB - 基礎](assets/cosmos-basics.png)\n\n* 「次へ: グローバル配布」をクリックします\n\n![Cosmos DB - グローバル配信](assets/cosmos-global-distribution.png)\n\n* デフォルト値を受け入れて、「次へ: ネットワーク」をクリックします。\n\n![Cosmos DB - ネットワーク](assets/cosmos-networking.png)\n\n* デフォルト値を受け入れて、「次へ: バックアップポリシー」をクリックします。\n* 「定期」バックアップポリシーを選択する\n* 「ローカル冗長バックアップストレージ」を選択します\n\n![Cosmos DB - バックアップポリシー](assets/cosmos-backup-policy.png)\n\n* 「次へ: 暗号化」をクリックします\n\n![Cosmos DB - 暗号化](assets/cosmos-encryption.png)\n\n* 「確認と作成」をクリックして検証を開始します\n\n![Cosmos DB - 検証](assets/cosmos-validation.png)\n\n* 「作成」をクリックして、Azure Cosmos DB for NoSQL アカウントの作成を開始します。\n\nこのプロジェクトでは、Azure Cosmos DB アカウントでベクターサポートを有効にする必要があります。\n\n* 設定セクションで、「機能」を選択し、「Vector Search for NoSQL API」を選択します。\n\n* 開いたパネルで、「有効にする」ボタンをクリックします。\n\n![Cosmos DB - 検証](assets/cosmos-enable-vector-search.png)\n\n* Azure Cosmos DB eShop データベースと製品コンテナーを作成する\n\n* eShop の横にある「...」をクリックしてコンテキストメニューを表示し、「新しいコンテナー」を選択して、eShop データベースに「カート」コンテナーを作成します。\n\nパーティションキーが\\*\\*\\*「/id」\\*\\*\\*であることを確認してください（パーティションキーでは大文字と小文字が区別されます）\n\n「コンテナベクターポリシー」を展開し、「ベクター埋め込みを追加」ボタンをクリックします。\n\n![Cosmos DB - データベースの作成](assets/cosmos-create-products.png)\n\n* カートコンテナを作成する\n\n![Cosmos DB - データベースの作成](assets/cosmos-create-carts.png)\n\n**ストレージアカウント**\n\n1. 製品画像を保存するためのストレージアカウントを作成する\n\n詳細については、次のドキュメントを参照してください: \n\n![ストレージ - 基本](assets/storage-basics.png)\n\n![ストレージ - 高度](assets/storage-advanced.png)\n\n![ストレージ - ネットワーク](assets/storage-networking.png)\n\n![ストレージ - データ保護](assets/storage-data-protection.png)\n\n![ストレージ - 暗号化](assets/storage-encryption.png)\n\n![保管 - 検証](assets/storage-validation.png)\n\n\\*\\*ソフトウェアの前提条件をインストールする\\*\\*\n\n1. Azureで仮想マシンを作成するか、ローカルコンピューターを使用する\n2. から node.js v22.13.1 (LTS) をインストールします。\n3. から Visual Studio Code x64 1.97.0 をインストールします。\n4. から Git 2.47.12 x64 をインストールします。\n5. から .NET SDK x64 v9.0.102 をインストールします。\n6. ターミナルウィンドウを開き、NuGetソースを追加します。\n\n```sh\ndotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org\n```\n\n7. 必要に応じて、WindowsコンピュータのPowerShell実行ポリシーを変更します。**管理者モードで**PowerShellウィンドウを開き、次のコマンドを実行します。\n\n```sh\nSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser\n```\n\n8. 必要に応じて、NuGet、PowerShell、az cli、azモジュールをインストールします。\n\n```sh\n# install az cli\nwinget install -e --id Microsoft.AzureCLI\n\n# install nuget and reference nuget source\nInstall-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force\n\n# update to latest Powershell release (7.5 as of writing)\nwinget install --id Microsoft.PowerShell --source winget\n\n# install az modules\nInstall-Module -Name Az -Repository PSGallery -Force -AllowClobber\n```\n\n9. ターミナルウィンドウを開き、リポジトリのクローンを作成します。\n\n```sh\ngit clone https://github.com/patrice-truong/cosmosdb-mcp.git\ncd cosmosdb-mcp\n```\n\n10. nextjsフォルダに移動して依存関係をインストールします\n\n```sh\ncd cosmosdb-mcp/nextjs\nnpm install --legacy-peer-deps\n```\n\n11. nextjs フォルダーで、次の値を持つ .env ファイルを作成して構成します。\n\n```sh\nAZURE_COSMOSDB_NOSQL_ENDPOINT=https://.documents.azure.com:443/\nAZURE_COSMOSDB_NOSQL_DATABASE=eshop\nAZURE_COSMOSDB_NOSQL_PRODUCTS_CONTAINER=products\nAZURE_COSMOSDB_NOSQL_CARTS_CONTAINER=carts\nAZURE_COSMOSDB_NOSQL_ORDERS_CONTAINER=orders\nAZURE_STORAGE_ACCOUNT_NAME=\nAZURE_STORAGE_CONTAINER_NAME=\n```\n\n12. テナントIDを取得します。テナントIDは次のコマンドで取得できます。\n\n```sh\naz login\naz account show --query tenantId -o tsv\n```\n\n13. webapi フォルダーで、appsettings.json ファイルを構成し、tenant\\_id を前の手順で取得した値に置き換えます。\n\n```sh\n{\n \"CosmosDb\": {\n \"Endpoint\": \"https:/.documents.azure.com:443/\",\n \"TenantId\": \"\",\n \"DatabaseName\": \"eshop\",\n \"ProductsContainerName\": \"products\",\n \"CartsContainerName\": \"carts\",\n \"OrdersContainerName\": \"orders\"\n },\n \"AzureBlobStorage\": {\n \"AccountName\": \"\"\n }\n}\n```\n\n14. Azure ポータルでアプリ登録を作成する\n15. Azureポータルでアプリシークレットを作成する\n16. アプリにAzure Cosmos DBへのアクセスを許可する必要があります。以下の4つのIDを取得し、「populate/set\\_rbac.ps1」ファイルを変更してください。\n\n| 変数 | 参照 |\n| ---------------------- | ----------------------------- |\n| サブスクリプションID | Cosmos DB > 概要 > サブスクリプション ID |\n| Azure Cosmos DB アカウント名 | コスモス-eastus2-nosql-2 |\n| リソースグループ名 | Cosmos DB > 概要 > リソースグループ名 |\n| プリンシパルID | アプリ登録オブジェクトID |\n\n```sh\n$SubscriptionId = \"\" # Azure subscription id\n$AccountName = \"\" # cosmos db account name\n$ResourceGroupName = \"\" # resource group name of the Cosmos DB account\n$PrincipalId = \"\" # object id of the app registered in Entra ID\n```\n\n17. Powershellプロンプトを開き、Connect-AzAccountを実行して、./set\\_rbac.ps1を実行します。\n\n![Cosmos DB - RBAC](assets/cosmos-rbac.png)\n\n18. アプリ（または仮想マシン）がストレージアカウントにアクセスできるようにします\n\n* Azureポータルでストレージアカウントに移動します\n* メニューでアクセス制御（IAM）を選択します\n\n![ストレージ - アクセス制御](assets/storage-access-control.png)\n\n* 「役割の割り当てを追加」をクリックします\n* フィルターテキストボックスに「Storage Blob Data Contributor」と入力します\n\n![ストレージ - Blob データコントリビューター](assets/storage-blob-data-contributor.png)\n\n* 「メンバー」をクリック\n* アプリケーションの名前を選択してください\n\n![ストレージ - 役割の割り当て](assets/storage-role-assignment.png)\n\n* 「選択」ボタンをクリックします\n* 「確認して割り当てる」をクリックします\n\n![ストレージ - 役割の割り当て](assets/storage-review.png)\n\n19. コンテナを作成し、「azure-storage」フォルダの内容をストレージアカウントにコピーします。\n\n![ストレージ - コンテナの作成](assets/storage-create-container.png)\n\n![ストレージ - ファイルのアップロード](assets/storage-upload-files.png)\n\n![ストレージ - アップロードされたファイル](assets/storage-files-uploaded.png)\n\n20. dotnet build で WebAPI バックエンドプロジェクトをビルドする\n\n```sh\ncd webapi\ndotnet build\n```\n\n![ドットネットビルド](assets/dotnet_build.png) 18. セカンダリリージョンVM（オーストラリア東部）で、プライマリリージョン（米国東部2）のソケットサーバーのIPアドレスを使用して.envファイルを変更します。\n\n![ソケットサーバーのIP](assets/socket_server_ip.png)\n\n19. このプロジェクトには認証機能が組み込まれていません。ユーザーのメールアドレスは/nextjs/models/constants.tsにハードコードされています。デモのニーズに合わせて変更してください。\n\n![npm 実行ビルド](assets/constants_email.png)\n\n19. mcp-server と nextjs フォルダで、.env.template を .env にコピーし、デモのニーズに合わせて値を変更します。\n\n```json\nAZURE_COSMOSDB_NOSQL_ENDPOINT=https://.documents.azure.com:443/\nAZURE_COSMOSDB_NOSQL_DATABASE=eshop\nAZURE_COSMOSDB_NOSQL_PRODUCTS_CONTAINER=products\nAZURE_COSMOSDB_NOSQL_CARTS_CONTAINER=carts\nAZURE_COSMOSDB_NOSQL_ORDERS_CONTAINER=orders\n\nNEXT_PUBLIC_AZURE_TENANT_ID=\nNEXT_PUBLIC_AZURE_CLIENT_ID=\nNEXT_PUBLIC_AZURE_CLIENT_SECRET=\n\nNEXT_PUBLIC_AZURE_STORAGE_ACCOUNT_NAME=\nNEXT_PUBLIC_AZURE_STORAGE_CONTAINER_NAME=img\n\nAZURE_OPENAI_ENDPOINT=https://.openai.azure.com/\nAZURE_OPENAI_API_KEY=\nAZURE_OPENAI_EMBEDDING_MODEL=text-embedding-3-small\nAZURE_OPENAI_API_VERSION=2024-05-01-preview\n```\n\n20. Nextjsフロントエンドプロジェクトをビルドする\n\n```sh\ncd nextjs\nnpm run build\n```\n\n![npm 実行ビルド](assets/npm_run_build.png)\n\n## 製品カタログに情報を追加する\n\nこのセクションでは、populate/catalog.json ファイルから製品カタログを読み取り、Azure Cosmos DB for NoSQL データベースに入力します。\n\n1. appsettings.jsonをcosmosdbアカウント名に変更し、\n\n```json\n{\n \"CosmosDb\": {\n \"Endpoint\": \"https://.documents.azure.com:443/\",\n \"TenantId\": \"\",\n \"DatabaseName\": \"eshop\",\n \"ProductsContainerName\": \"products\",\n \"OrdersContainerName\": \"orders\",\n }\n}\n```\n\n2. ターミナルウィンドウを開き、populateフォルダに移動し、az loginを実行してからdotnet runを実行します。\n\n![Cosmos - Populate製品](assets/cosmos-populate-products.png)\n\n3. Azure Cosmos DB コンテナーが適切に設定されていることを確認します\n\n![コスモス - 製品](assets/cosmos-products.png)\n\n## デモスクリプト\n\n**デモの初期化:**\n\n3. 開発用コンピュータで、mcpサーバーを起動します。\n\n```sh\ncd mcp-server\nnpx ts-node src/server.ts\n```\n\n3. フロントエンドプロジェクトを開始する\n\n* NextJS フロントエンド（ストアフロント）\n * cd nextjs\n * npm スタート\n\n4. オプションとして、コマンドプロンプトを開き、次のコマンドでMCPインスペクターを起動します: npx -y @modelcontextprotocol/inspector\n\n**デモの手順:**\n\n1. に移動します。\n2. 右上隅のAIアシスタントアイコンをクリックします\n3. 「バックパックに興味があります」と入力します（商品リストが更新され、バックパックのリストが表示されます）\n4. 「注文を取得」と入力します（注文リストが更新されます）\n\n![デモ](assets/demo.gif)","Japanese","ja-JP",{"_27":53,"_31":57,"_36":58},{"_29":54,"_31":55,"_33":56},"Azure Cosmos DB NoSQL 데이터베이스에 연결되는 Node.js 서버로, 사용자는 NextJS 프런트엔드 애플리케이션의 AI Assistant를 통해 제품과 주문을 쿼리할 수 있습니다.","Azure Cosmos DB MCP 서버","# Azure Cosmos DB MCP 클라이언트 및 서버\n\n이 리포지토리에는 Azure Cosmos DB용 MCP 서버와 클라이언트를 만드는 방법을 보여주는 프로젝트가 포함되어 있습니다. 이 프로젝트는 두 부분으로 나뉩니다.\n\n* 프런트엔드 애플리케이션: 제품 카탈로그를 표시하고 사용자가 카탈로그에서 제품을 찾고 이전 주문을 확인할 수 있도록 돕는 AI 어시스턴트를 갖춘 NextJS 15 애플리케이션\n* Azure Cosmos DB NoSQL 데이터베이스에 연결되어 데이터베이스에서 제품과 주문을 읽는 역할을 하는 MCP 서버 구성 요소입니다.\n\n![데모](assets/demo.gif)\n\n## Azure 아키텍처\n\n* 제품 카탈로그를 저장하는 Azure Cosmos DB NoSQL 데이터베이스\n* MCP 서버 구성 요소 역할을 하는 node.js 서버\n\n## 참고문헌\n\n* [NoSQL용 Azure Cosmos DB 계정 만들기](https://learn.microsoft.com/en-us/azure/cosmos-db/nosql/quickstart-portal)\n* [Azure Storage 계정 만들기](https://learn.microsoft.com/en-us/azure/storage/common/storage-account-create?tabs=azure-portal)\n* [Windows 가상 머신 만들기](https://learn.microsoft.com/en-us/azure/virtual-machines/windows/quick-create-portal)\n* [Windows 실행 정책](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/set-executionpolicy?view=powershell-7.5)\n\n## 단계별 연습\n\n### 설치\n\n**애저 코스모스 DB**\n\nAzure Portal에서 Azure Cosmos DB for NoSQL 계정을 만듭니다.\n\n* Azure Cosmos DB 계정에 고유한 이름을 지정하세요. 이 연습의 나머지 부분에서는 cosmos-eastus2-nosql-2를 사용합니다.\n\n![코스모스 DB - 기본 사항](assets/cosmos-basics.png)\n\n* \"다음: 글로벌 배포\"를 클릭하세요.\n\n![Cosmos DB - 글로벌 배포](assets/cosmos-global-distribution.png)\n\n* 기본값을 수락하고 \"다음: 네트워킹\"을 클릭합니다.\n\n![코스모스 DB - 네트워킹](assets/cosmos-networking.png)\n\n* 기본값을 수락하고 \"다음: 백업 정책\"을 클릭합니다.\n* \"주기적\" 백업 정책을 선택하세요\n* \"로컬 중복 백업 저장소\"를 선택하세요\n\n![Cosmos DB - 백업 정책](assets/cosmos-backup-policy.png)\n\n* \"다음: 암호화\"를 클릭하세요.\n\n![코스모스 DB - 암호화](assets/cosmos-encryption.png)\n\n* \"검토 및 생성\"을 클릭하여 검증을 시작하세요.\n\n![코스모스 DB - 검증](assets/cosmos-validation.png)\n\n* \"만들기\"를 클릭하여 Azure Cosmos DB for NoSQL 계정 만들기를 시작하세요.\n\n이 프로젝트에서는 Azure Cosmos DB 계정에서 벡터 지원을 활성화해야 합니다.\n\n* 설정 섹션에서 기능을 선택한 다음 \"NoSQL API에 대한 벡터 검색\"을 선택합니다.\n\n* 열리는 패널에서 활성화 버튼을 클릭하세요.\n\n![코스모스 DB - 검증](assets/cosmos-enable-vector-search.png)\n\n* Azure Cosmos DB eShop 데이터베이스와 제품 컨테이너를 만듭니다.\n\n* eShop 옆에 있는 \"...\"을 클릭하여 상황에 맞는 메뉴를 표시하고 \"새 컨테이너\"를 선택하여 eShop 데이터베이스에 \"카트\" 컨테이너를 만듭니다.\n\n파티션 키가 ***\"/id\"*** 인지 확인하세요(파티션 키는 대소문자를 구분합니다)\n\n\"컨테이너 벡터 정책\"을 확장하고 \"벡터 임베딩 추가\" 버튼을 클릭합니다.\n\n![Cosmos DB - 데이터베이스 생성](assets/cosmos-create-products.png)\n\n* 카트 컨테이너 만들기\n\n![Cosmos DB - 데이터베이스 생성](assets/cosmos-create-carts.png)\n\n**저장 계정**\n\n1. 제품 이미지를 저장하기 위한 저장소 계정을 생성하세요\n\n자세한 내용은 다음 설명서를 참조하세요: \n\n![보관 - 기본 사항](assets/storage-basics.png)\n\n![스토리지 - 고급](assets/storage-advanced.png)\n\n![스토리지 - 네트워킹](assets/storage-networking.png)\n\n![저장 - 데이터 보호](assets/storage-data-protection.png)\n\n![저장 - 암호화](assets/storage-encryption.png)\n\n![저장 - 검증](assets/storage-validation.png)\n\n\\*\\*소프트웨어 필수 구성 요소 설치\\*\\*\n\n1. Azure에서 가상 머신을 만들거나 로컬 컴퓨터를 사용하세요.\n2. 에서 node.js v22.13.1(LTS)을 설치하세요.\n3. 에서 Visual Studio Code x64 1.97.0을 설치하세요.\n4. 에서 Git 2.47.12 x64를 설치하세요.\n5. 에서 .NET SDK x64 v9.0.102를 설치하세요.\n6. 터미널 창을 열고 NuGet 소스를 추가하세요.\n\n지엑스피1\n\n7. 필요한 경우 Windows 컴퓨터의 PowerShell 실행 정책을 변경하세요. PowerShell 창을 **관리자 모드로** 열고 다음 명령을 실행하세요.\n\n```sh\nSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser\n```\n\n8. 필요한 경우 nuget, powershell, az cli 및 az 모듈을 설치하세요.\n\n```sh\n# install az cli\nwinget install -e --id Microsoft.AzureCLI\n\n# install nuget and reference nuget source\nInstall-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force\n\n# update to latest Powershell release (7.5 as of writing)\nwinget install --id Microsoft.PowerShell --source winget\n\n# install az modules\nInstall-Module -Name Az -Repository PSGallery -Force -AllowClobber\n```\n\n9. 터미널 창을 열고 저장소를 복제합니다.\n\n```sh\ngit clone https://github.com/patrice-truong/cosmosdb-mcp.git\ncd cosmosdb-mcp\n```\n\n10. nextjs 폴더로 이동하여 종속성을 설치합니다.\n\n```sh\ncd cosmosdb-mcp/nextjs\nnpm install --legacy-peer-deps\n```\n\n11. nextjs 폴더에서 다음 값을 사용하여 .env 파일을 만들고 구성합니다.\n\n```sh\nAZURE_COSMOSDB_NOSQL_ENDPOINT=https://.documents.azure.com:443/\nAZURE_COSMOSDB_NOSQL_DATABASE=eshop\nAZURE_COSMOSDB_NOSQL_PRODUCTS_CONTAINER=products\nAZURE_COSMOSDB_NOSQL_CARTS_CONTAINER=carts\nAZURE_COSMOSDB_NOSQL_ORDERS_CONTAINER=orders\nAZURE_STORAGE_ACCOUNT_NAME=\nAZURE_STORAGE_CONTAINER_NAME=\n```\n\n12. 테넌트 ID를 확인하세요. 다음 명령을 사용하여 테넌트 ID를 검색할 수 있습니다.\n\n```sh\naz login\naz account show --query tenantId -o tsv\n```\n\n13. webapi 폴더에서 appsettings.json 파일을 구성하고 tenant\\_id를 이전 단계에서 얻은 값으로 바꿉니다.\n\n```sh\n{\n \"CosmosDb\": {\n \"Endpoint\": \"https:/.documents.azure.com:443/\",\n \"TenantId\": \"\",\n \"DatabaseName\": \"eshop\",\n \"ProductsContainerName\": \"products\",\n \"CartsContainerName\": \"carts\",\n \"OrdersContainerName\": \"orders\"\n },\n \"AzureBlobStorage\": {\n \"AccountName\": \"\"\n }\n}\n```\n\n14. Azure Portal에서 앱 등록 만들기\n15. Azure Portal에서 앱 비밀 만들기\n16. 앱이 Azure Cosmos DB에 액세스할 수 있도록 허용해야 합니다. 아래 언급된 4개의 ID를 검색하여 \"populate/set\\_rbac.ps1\" 파일을 수정하세요.\n\n| 변하기 쉬운 | 참조 |\n| --------------------- | -------------------------- |\n| 구독 ID | Cosmos DB > 개요 > 구독 ID |\n| Azure Cosmos DB 계정 이름 | 코스모스-eastus2-nosql-2 |\n| 리소스 그룹 이름 | Cosmos DB > 개요 > 리소스 그룹 이름 |\n| 교장 ID | 앱 등록 개체 ID |\n\n```sh\n$SubscriptionId = \"\" # Azure subscription id\n$AccountName = \"\" # cosmos db account name\n$ResourceGroupName = \"\" # resource group name of the Cosmos DB account\n$PrincipalId = \"\" # object id of the app registered in Entra ID\n```\n\n17. PowerShell 프롬프트를 열고 Connect-AzAccount를 실행한 후 ./set\\_rbac.ps1을 실행합니다.\n\n![코스모스 DB - RBAC](assets/cosmos-rbac.png)\n\n18. 앱(또는 가상 머신)이 저장소 계정에 액세스하도록 허용합니다.\n\n* Azure Portal에서 저장소 계정으로 이동하세요.\n* 메뉴에서 액세스 제어(IAM)를 선택하세요\n\n![보관 - 접근 제어](assets/storage-access-control.png)\n\n* \"역할 할당 추가\"를 클릭하세요.\n* 필터 텍스트 상자에 \"Storage Blob Data Contributor\"를 입력합니다.\n\n![저장소 - Blob 데이터 기여자](assets/storage-blob-data-contributor.png)\n\n* \"회원\"을 클릭하세요\n* 애플리케이션 이름을 선택하세요\n\n![저장소 - 역할 할당](assets/storage-role-assignment.png)\n\n* \"선택\" 버튼을 클릭하세요\n* \"검토 및 할당\"을 클릭하세요.\n\n![저장소 - 역할 할당](assets/storage-review.png)\n\n19. 컨테이너를 만들고 \"azure-storage\" 폴더의 내용을 스토리지 계정에 복사합니다.\n\n![저장소 - 컨테이너 생성](assets/storage-create-container.png)\n\n![저장소 - 파일 업로드](assets/storage-upload-files.png)\n\n![저장 - 업로드된 파일](assets/storage-files-uploaded.png)\n\n20. dotnet build로 webapi 백엔드 프로젝트 빌드\n\n```sh\ncd webapi\ndotnet build\n```\n\n![Dotnet 빌드](assets/dotnet_build.png) 18. 보조 지역 VM(호주 동부)에서 기본 지역(미국 동부 2)의 소켓 서버의 IP 주소로 .env 파일을 수정합니다.\n\n![소켓\\_서버\\_IP](assets/socket_server_ip.png)\n\n19. 이 프로젝트에는 인증 기능이 내장되어 있지 않습니다. 사용자 이메일은 /nextjs/models/constants.ts에 하드코딩되어 있습니다. 데모 요구 사항에 맞게 변경하세요.\n\n![npm 실행 빌드](assets/constants_email.png)\n\n19. mcp-server 및 nextjs 폴더에서 .env.template을 .env로 복사하고 데모 요구 사항에 맞게 값을 수정합니다.\n\n```json\nAZURE_COSMOSDB_NOSQL_ENDPOINT=https://.documents.azure.com:443/\nAZURE_COSMOSDB_NOSQL_DATABASE=eshop\nAZURE_COSMOSDB_NOSQL_PRODUCTS_CONTAINER=products\nAZURE_COSMOSDB_NOSQL_CARTS_CONTAINER=carts\nAZURE_COSMOSDB_NOSQL_ORDERS_CONTAINER=orders\n\nNEXT_PUBLIC_AZURE_TENANT_ID=\nNEXT_PUBLIC_AZURE_CLIENT_ID=\nNEXT_PUBLIC_AZURE_CLIENT_SECRET=\n\nNEXT_PUBLIC_AZURE_STORAGE_ACCOUNT_NAME=\nNEXT_PUBLIC_AZURE_STORAGE_CONTAINER_NAME=img\n\nAZURE_OPENAI_ENDPOINT=https://.openai.azure.com/\nAZURE_OPENAI_API_KEY=\nAZURE_OPENAI_EMBEDDING_MODEL=text-embedding-3-small\nAZURE_OPENAI_API_VERSION=2024-05-01-preview\n```\n\n20. nextjs 프런트엔드 프로젝트 빌드\n\n```sh\ncd nextjs\nnpm run build\n```\n\n![npm 실행 빌드](assets/npm_run_build.png)\n\n## 제품 카탈로그를 채우세요\n\n이 섹션에서는 populate/catalog.json 파일에서 제품 카탈로그를 읽고 NoSQL 데이터베이스용 Azure Cosmos DB를 채웁니다.\n\n1. cosmosdb 계정 이름으로 appsettings.json을 수정하세요.\n\n```json\n{\n \"CosmosDb\": {\n \"Endpoint\": \"https://.documents.azure.com:443/\",\n \"TenantId\": \"\",\n \"DatabaseName\": \"eshop\",\n \"ProductsContainerName\": \"products\",\n \"OrdersContainerName\": \"orders\",\n }\n}\n```\n\n2. 터미널 창을 열고 populate 폴더로 이동한 후 az login을 실행한 다음 dotnet run을 실행합니다.\n\n![코스모스 - 제품 채우기](assets/cosmos-populate-products.png)\n\n3. Azure Cosmos DB 컨테이너가 제대로 채워졌는지 확인하세요.\n\n![코스모스 - 제품](assets/cosmos-products.png)\n\n## 데모 스크립트\n\n**데모 초기화:**\n\n3. 개발용 컴퓨터에서 mcp 서버를 시작하세요.\n\n```sh\ncd mcp-server\nnpx ts-node src/server.ts\n```\n\n3. 프런트엔드 프로젝트 시작\n\n* NextJS 프런트엔드(스토어 프런트)\n * cd 넥스트js\n * npm 시작\n\n4. 선택적으로 명령 프롬프트를 열고 다음 명령으로 MCP 검사기를 시작합니다: npx -y @modelcontextprotocol/inspector\n\n**데모 단계:**\n\n1. 로 이동합니다.\n2. 오른쪽 상단의 AI Assistant 아이콘을 클릭하세요\n3. \"백팩에 관심이 있어요\"를 입력하세요(백팩 목록이 있는 제품 새로 고침 목록)\n4. \"내 주문 가져오기\"를 입력하세요(주문 목록이 주문 목록으로 새로 고쳐집니다)\n\n![데모](assets/demo.gif)","Korean","ko-KR",{"_27":60,"_31":64,"_36":65},{"_29":61,"_31":62,"_33":63},"连接到 Azure Cosmos DB NoSQL 数据库的 Node.js 服务器，允许用户通过 NextJS 前端应用程序中的 AI 助手查询产品和订单。","Azure Cosmos DB MCP 服务器","# Azure Cosmos DB MCP 客户端和服务器\n\n此存储库包含一个项目，展示了如何为 Azure Cosmos DB 创建 MCP 服务器和客户端。该项目分为两部分：\n\n* 前端应用程序：NextJS 15 应用程序，显示产品目录并具有 AI 助手，可帮助用户在目录中查找产品并获取过去的订单\n* MCP 服务器组件，连接到 Azure Cosmos DB NoSQL 数据库并负责从数据库中读取产品和订单。\n\n![演示](assets/demo.gif)\n\n## Azure 体系结构Azure Architecture\n\n* 存储产品目录的 Azure Cosmos DB NoSQL 数据库\n* 一个用作 MCP 服务器组件的 node.js 服务器\n\n## 参考\n\n* [创建 Azure Cosmos DB for NoSQL 帐户](https://learn.microsoft.com/en-us/azure/cosmos-db/nosql/quickstart-portal)\n* [创建 Azure 存储帐户](https://learn.microsoft.com/en-us/azure/storage/common/storage-account-create?tabs=azure-portal)\n* [创建 Windows 虚拟机](https://learn.microsoft.com/en-us/azure/virtual-machines/windows/quick-create-portal)\n* [Windows 执行策略](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/set-executionpolicy?view=powershell-7.5)\n\n## 分步演练\n\n### 安装\n\n**Azure Cosmos DB**\n\n在 Azure 门户中，创建一个 Azure Cosmos DB for NoSQL 帐户。\n\n* 为 Azure Cosmos DB 帐户指定一个唯一的名称。在本演练的其余部分中，我们将使用 cosmos-eastus2-nosql-2。\n\n![Cosmos DB 基础知识](assets/cosmos-basics.png)\n\n* 点击“下一步：全球分发”\n\n![Cosmos DB - 全球分布](assets/cosmos-global-distribution.png)\n\n* 接受默认值并点击“下一步：网络”\n\n![Cosmos DB - 网络](assets/cosmos-networking.png)\n\n* 接受默认值并点击“下一步：备份策略”\n* 选择“定期”备份策略\n* 选择“本地冗余备份存储”\n\n![Cosmos DB - 备份策略](assets/cosmos-backup-policy.png)\n\n* 点击“下一步：加密”\n\n![Cosmos DB - 加密](assets/cosmos-encryption.png)\n\n* 点击“审核并创建”开始验证\n\n![Cosmos DB - 验证](assets/cosmos-validation.png)\n\n* 单击“创建”开始创建 Azure Cosmos DB for NoSQL 帐户\n\n对于此项目，您需要在 Azure Cosmos DB 帐户上启用矢量支持。\n\n* 在设置部分中，选择“功能”，然后选择“NoSQL API 的矢量搜索”\n\n* 在打开的面板中，单击启用按钮\n\n![Cosmos DB - 验证](assets/cosmos-enable-vector-search.png)\n\n* 创建 Azure Cosmos DB eShop 数据库和 Products 容器\n\n* 单击 eShop 旁边的“...”以显示上下文菜单，然后选择“新建容器”以在 eShop 数据库中创建“carts”容器。\n\n确保分区键是\\*\\*\\*“/id”\\*\\*\\* （分区键区分大小写）\n\n展开“容器向量策略”，点击“添加向量嵌入”按钮\n\n![Cosmos DB - 创建数据库](assets/cosmos-create-products.png)\n\n* 创建购物车容器\n\n![Cosmos DB - 创建数据库](assets/cosmos-create-carts.png)\n\n**存储帐户**\n\n1. 创建存储帐户来存储产品图像\n\n有关更多详细信息，请参阅文档： [https://learn.microsoft.com/en-us/azure/storage/common/storage-account-create?](https://learn.microsoft.com/en-us/azure/storage/common/storage-account-create?tabs=azure-portal) tabs=azure-portal\n\n![存储 - 基础知识](assets/storage-basics.png)\n\n![存储 - 高级](assets/storage-advanced.png)\n\n![存储 - 网络](assets/storage-networking.png)\n\n![存储 - 数据保护](assets/storage-data-protection.png)\n\n![存储 - 加密](assets/storage-encryption.png)\n\n![存储-验证](assets/storage-validation.png)\n\n\\*\\*安装软件先决条件\\*\\*\n\n1. 在 Azure 中创建虚拟机或使用本地计算机\n2. 从安装 node.js v22.13.1 (LTS)\n3. 从安装 Visual Studio Code x64 1.97.0\n4. 从安装 Git 2.47.12 x64\n5. 从安装 .NET SDK x64 v9.0.102\n6. 打开终端窗口并添加 nuget 源\n\n```sh\ndotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org\n```\n\n7. 如有必要，请更改 Windows 计算机的 PowerShell 执行策略。**以管理员模式**打开 Powershell 窗口并运行以下命令\n\n```sh\nSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser\n```\n\n8. 如果需要，安装 nuget、powershell、az cli 和 az 模块\n\n```sh\n# install az cli\nwinget install -e --id Microsoft.AzureCLI\n\n# install nuget and reference nuget source\nInstall-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force\n\n# update to latest Powershell release (7.5 as of writing)\nwinget install --id Microsoft.PowerShell --source winget\n\n# install az modules\nInstall-Module -Name Az -Repository PSGallery -Force -AllowClobber\n```\n\n9. 打开终端窗口并克隆存储库：\n\n```sh\ngit clone https://github.com/patrice-truong/cosmosdb-mcp.git\ncd cosmosdb-mcp\n```\n\n10. 导航到 nextjs 文件夹并安装依赖项\n\n```sh\ncd cosmosdb-mcp/nextjs\nnpm install --legacy-peer-deps\n```\n\n11. 在 nextjs 文件夹中，创建并配置一个 .env 文件，其值如下：\n\n```sh\nAZURE_COSMOSDB_NOSQL_ENDPOINT=https://.documents.azure.com:443/\nAZURE_COSMOSDB_NOSQL_DATABASE=eshop\nAZURE_COSMOSDB_NOSQL_PRODUCTS_CONTAINER=products\nAZURE_COSMOSDB_NOSQL_CARTS_CONTAINER=carts\nAZURE_COSMOSDB_NOSQL_ORDERS_CONTAINER=orders\nAZURE_STORAGE_ACCOUNT_NAME=\nAZURE_STORAGE_CONTAINER_NAME=\n```\n\n12. 获取您的租户 ID。您可以使用以下命令检索租户 ID：\n\n```sh\naz login\naz account show --query tenantId -o tsv\n```\n\n13. 在webapi文件夹中，配置appsettings.json文件，将tenant\\_id替换为上一步获取的值：\n\n```sh\n{\n \"CosmosDb\": {\n \"Endpoint\": \"https:/.documents.azure.com:443/\",\n \"TenantId\": \"\",\n \"DatabaseName\": \"eshop\",\n \"ProductsContainerName\": \"products\",\n \"CartsContainerName\": \"carts\",\n \"OrdersContainerName\": \"orders\"\n },\n \"AzureBlobStorage\": {\n \"AccountName\": \"\"\n }\n}\n```\n\n14. 在 Azure 门户中创建应用程序注册\n15. 在 Azure 门户中创建应用程序机密\n16. 您需要允许您的应用访问 Azure Cosmos DB。检索下面提到的 4 个 ID，并修改文件“populate/set\\_rbac.ps1”。\n\n| 多变的 | 参考 |\n| -------------------- | ---------------------- |\n| 订阅 ID | Cosmos DB > 概览 > 订阅 ID |\n| Azure Cosmos DB 帐户名称 | cosmos-eastus2-nosql-2 |\n| 资源组名称 | Cosmos DB > 概述 > 资源组名称 |\n| 委托人 ID | 应用程序注册对象 ID |\n\n```sh\n$SubscriptionId = \"\" # Azure subscription id\n$AccountName = \"\" # cosmos db account name\n$ResourceGroupName = \"\" # resource group name of the Cosmos DB account\n$PrincipalId = \"\" # object id of the app registered in Entra ID\n```\n\n17. 打开 Powershell 提示符，运行 Connect-AzAccount 并执行 ./set\\_rbac.ps1\n\n![Cosmos DB - RBAC](assets/cosmos-rbac.png)\n\n18. 允许您的应用（或虚拟机）访问存储帐户\n\n* 在 Azure 门户中，转到你的存储帐户\n* 在菜单中选择访问控制（IAM）\n\n![存储 - 访问控制](assets/storage-access-control.png)\n\n* 点击“添加角色分配”\n* 在过滤器文本框中，键入“存储 Blob 数据贡献者”\n\n![存储 - Blob 数据贡献者](assets/storage-blob-data-contributor.png)\n\n* 点击“会员”\n* 选择您的应用程序名称\n\n![存储 - 角色分配](assets/storage-role-assignment.png)\n\n* 点击“选择”按钮\n* 点击“审核并分配”\n\n![存储 - 角色分配](assets/storage-review.png)\n\n19. 创建一个容器并将“azure-storage”文件夹的内容复制到你的存储帐户\n\n![存储 - 创建容器](assets/storage-create-container.png)\n\n![存储 - 上传文件](assets/storage-upload-files.png)\n\n![存储 - 已上传的文件](assets/storage-files-uploaded.png)\n\n20. 使用 dotnet build 构建 webapi 后端项目\n\n```sh\ncd webapi\ndotnet build\n```\n\n![Dotnet 构建](assets/dotnet_build.png) 18. 在您的次要区域虚拟机（澳大利亚东部）上，使用您的主要区域（美国东部 2）中的套接字服务器的 IP 地址修改 .env 文件\n\n![socket\\_server\\_ip](assets/socket_server_ip.png)\n\n19. 该项目未内置身份验证。用户邮箱地址已硬编码在 /nextjs/models/constants.ts 中。请根据你的演示需求进行修改。\n\n![npm 运行构建](assets/constants_email.png)\n\n19. 在 mcp-server 和 nextjs 文件夹中，将 .env.template 复制到 .env 并修改其值以满足您的演示需求\n\n```json\nAZURE_COSMOSDB_NOSQL_ENDPOINT=https://.documents.azure.com:443/\nAZURE_COSMOSDB_NOSQL_DATABASE=eshop\nAZURE_COSMOSDB_NOSQL_PRODUCTS_CONTAINER=products\nAZURE_COSMOSDB_NOSQL_CARTS_CONTAINER=carts\nAZURE_COSMOSDB_NOSQL_ORDERS_CONTAINER=orders\n\nNEXT_PUBLIC_AZURE_TENANT_ID=\nNEXT_PUBLIC_AZURE_CLIENT_ID=\nNEXT_PUBLIC_AZURE_CLIENT_SECRET=\n\nNEXT_PUBLIC_AZURE_STORAGE_ACCOUNT_NAME=\nNEXT_PUBLIC_AZURE_STORAGE_CONTAINER_NAME=img\n\nAZURE_OPENAI_ENDPOINT=https://.openai.azure.com/\nAZURE_OPENAI_API_KEY=\nAZURE_OPENAI_EMBEDDING_MODEL=text-embedding-3-small\nAZURE_OPENAI_API_VERSION=2024-05-01-preview\n```\n\n20. 构建 nextjs 前端项目\n\n```sh\ncd nextjs\nnpm run build\n```\n\n![npm 运行构建](assets/npm_run_build.png)\n\n## 填充产品目录\n\n在本部分中，我们将从 populate/catalog.json 文件中读取产品目录，并填充 Azure Cosmos DB for NoSQL 数据库\n\n1. 使用您的 cosmosdb 帐户名称修改 appsettings.json 并\n\n```json\n{\n \"CosmosDb\": {\n \"Endpoint\": \"https://.documents.azure.com:443/\",\n \"TenantId\": \"\",\n \"DatabaseName\": \"eshop\",\n \"ProductsContainerName\": \"products\",\n \"OrdersContainerName\": \"orders\",\n }\n}\n```\n\n2. 打开终端窗口，导航到 populate 文件夹，执行 az login，然后执行 dotnet run\n\n![Cosmos - 填充产品](assets/cosmos-populate-products.png)\n\n3. 验证 Azure Cosmos DB 容器是否已正确填充\n\n![Cosmos - 产品](assets/cosmos-products.png)\n\n## 演示脚本\n\n**演示初始化：**\n\n3. 在你的开发计算机上，启动 mcp 服务器\n\n```sh\ncd mcp-server\nnpx ts-node src/server.ts\n```\n\n3. 启动前端项目\n\n* NextJS 前端（商店前端）\n * cd nextjs\n * npm 启动\n\n4. 或者，打开命令提示符并使用以下命令启动 MCP 检查器：npx -y @modelcontextprotocol/inspector\n\n**演示步骤：**\n\n1. 导航到。\n2. 点击右上角的AI助手图标\n3. 输入“我对背包感兴趣”（商品列表刷新，显示背包列表）\n4. 进入“获取我的订单”（订单列表刷新显示订单列表）\n\n![演示](assets/demo.gif)","Chinese","zh-CN","githubUser","locale",{"_69":70,"_13":71,"_79":30,"_80":30,"_16":81,"_82":83,"_31":32,"_116":117,"_124":-5,"_125":-5,"_126":127,"_219":220,"_225":-5,"_90":202,"_226":206,"_93":227,"_228":229},"addedAt","2025-04-01T15:06:48.946067Z",[72,73,74,75,76,77,78],"category:databases","category:rag-systems","category:ecommerce-and-retail","environment:network","hosting:remote-capable","language:typescript","license_grade:a","descriptionMarkdown","descriptionPlainText",4796,"integrations",[84,95,102,109],{"_85":86,"_29":92,"_93":94},"brand",{"_87":88,"_31":89,"_90":91},"logoSvgPath","M24 8.77h-2.468v7.565h-1.425V8.77h-2.462V7.53H24zm-6.852 7.565h-4.821V7.53h4.63v1.24h-3.205v2.494h2.953v1.234h-2.953v2.604h3.396zm-6.708 0H8.882L4.78 9.863a2.896 2.896 0 0 1-.258-.51h-.036c.032.189.048.592.048 1.21v5.772H3.157V7.53h1.659l3.965 6.32c.167.261.275.442.323.54h.024c-.04-.233-.06-.629-.06-1.185V7.529h1.372zm-8.703-.693a.868.829 0 0 1-.869.829.868.829 0 0 1-.868-.83.868.829 0 0 1 .868-.828.868.829 0 0 1 .869.829Z",".NET","slug","dotnet","Provides a backend implementation for the MCP server using .NET, connecting to Azure Cosmos DB for database operations","uid","fh9csxbqc5",{"_85":96,"_29":100,"_93":101},{"_87":97,"_31":98,"_90":99},"M11.998,24c-0.321,0-0.641-0.084-0.922-0.247l-2.936-1.737c-0.438-0.245-0.224-0.332-0.08-0.383 c0.585-0.203,0.703-0.25,1.328-0.604c0.065-0.037,0.151-0.023,0.218,0.017l2.256,1.339c0.082,0.045,0.197,0.045,0.272,0l8.795-5.076 c0.082-0.047,0.134-0.141,0.134-0.238V6.921c0-0.099-0.053-0.192-0.137-0.242l-8.791-5.072c-0.081-0.047-0.189-0.047-0.271,0 L3.075,6.68C2.99,6.729,2.936,6.825,2.936,6.921v10.15c0,0.097,0.054,0.189,0.139,0.235l2.409,1.392 c1.307,0.654,2.108-0.116,2.108-0.89V7.787c0-0.142,0.114-0.253,0.256-0.253h1.115c0.139,0,0.255,0.112,0.255,0.253v10.021 c0,1.745-0.95,2.745-2.604,2.745c-0.508,0-0.909,0-2.026-0.551L2.28,18.675c-0.57-0.329-0.922-0.945-0.922-1.604V6.921 c0-0.659,0.353-1.275,0.922-1.603l8.795-5.082c0.557-0.315,1.296-0.315,1.848,0l8.794,5.082c0.57,0.329,0.924,0.944,0.924,1.603 v10.15c0,0.659-0.354,1.273-0.924,1.604l-8.794,5.078C12.643,23.916,12.324,24,11.998,24z M19.099,13.993 c0-1.9-1.284-2.406-3.987-2.763c-2.731-0.361-3.009-0.548-3.009-1.187c0-0.528,0.235-1.233,2.258-1.233 c1.807,0,2.473,0.389,2.747,1.607c0.024,0.115,0.129,0.199,0.247,0.199h1.141c0.071,0,0.138-0.031,0.186-0.081 c0.048-0.054,0.074-0.123,0.067-0.196c-0.177-2.098-1.571-3.076-4.388-3.076c-2.508,0-4.004,1.058-4.004,2.833 c0,1.925,1.488,2.457,3.895,2.695c2.88,0.282,3.103,0.703,3.103,1.269c0,0.983-0.789,1.402-2.642,1.402 c-2.327,0-2.839-0.584-3.011-1.742c-0.02-0.124-0.126-0.215-0.253-0.215h-1.137c-0.141,0-0.254,0.112-0.254,0.253 c0,1.482,0.806,3.248,4.655,3.248C17.501,17.007,19.099,15.91,19.099,13.993z","Node.js","node-dot-js","Serves as the foundation for the MCP server component, connecting to Azure Cosmos DB to read products and orders data","gl8k4oc5gq",{"_85":103,"_29":107,"_93":108},{"_87":104,"_31":105,"_90":106},"M22.2819 9.8211a5.9847 5.9847 0 0 0-.5157-4.9108 6.0462 6.0462 0 0 0-6.5098-2.9A6.0651 6.0651 0 0 0 4.9807 4.1818a5.9847 5.9847 0 0 0-3.9977 2.9 6.0462 6.0462 0 0 0 .7427 7.0966 5.98 5.98 0 0 0 .511 4.9107 6.051 6.051 0 0 0 6.5146 2.9001A5.9847 5.9847 0 0 0 13.2599 24a6.0557 6.0557 0 0 0 5.7718-4.2058 5.9894 5.9894 0 0 0 3.9977-2.9001 6.0557 6.0557 0 0 0-.7475-7.0729zm-9.022 12.6081a4.4755 4.4755 0 0 1-2.8764-1.0408l.1419-.0804 4.7783-2.7582a.7948.7948 0 0 0 .3927-.6813v-6.7369l2.02 1.1686a.071.071 0 0 1 .038.052v5.5826a4.504 4.504 0 0 1-4.4945 4.4944zm-9.6607-4.1254a4.4708 4.4708 0 0 1-.5346-3.0137l.142.0852 4.783 2.7582a.7712.7712 0 0 0 .7806 0l5.8428-3.3685v2.3324a.0804.0804 0 0 1-.0332.0615L9.74 19.9502a4.4992 4.4992 0 0 1-6.1408-1.6464zM2.3408 7.8956a4.485 4.485 0 0 1 2.3655-1.9728V11.6a.7664.7664 0 0 0 .3879.6765l5.8144 3.3543-2.0201 1.1685a.0757.0757 0 0 1-.071 0l-4.8303-2.7865A4.504 4.504 0 0 1 2.3408 7.872zm16.5963 3.8558L13.1038 8.364 15.1192 7.2a.0757.0757 0 0 1 .071 0l4.8303 2.7913a4.4944 4.4944 0 0 1-.6765 8.1042v-5.6772a.79.79 0 0 0-.407-.667zm2.0107-3.0231l-.142-.0852-4.7735-2.7818a.7759.7759 0 0 0-.7854 0L9.409 9.2297V6.8974a.0662.0662 0 0 1 .0284-.0615l4.8303-2.7866a4.4992 4.4992 0 0 1 6.6802 4.66zM8.3065 12.863l-2.02-1.1638a.0804.0804 0 0 1-.038-.0567V6.0742a4.4992 4.4992 0 0 1 7.3757-3.4537l-.142.0805L8.704 5.459a.7948.7948 0 0 0-.3927.6813zm1.0976-2.3654l2.602-1.4998 2.6069 1.4998v2.9994l-2.5974 1.4997-2.6067-1.4997Z","OpenAI","openai","Integrates with Azure OpenAI services for text embeddings and the AI Assistant functionality that helps users find products and retrieve order information","mzvjfq51e9",{"_85":110,"_29":114,"_93":115},{"_87":111,"_31":112,"_90":113},"M2.93 11.171c0 5.92 3.778 10.957 9.063 12.829a13.652 13.652 0 0 0 6.513-4.89 13.497 13.497 0 0 0 2.564-7.939V3.274L11.997 0 2.933 3.274v7.897zm7.491-6.09h4.208L13.34 9.47h2.292l-6.264 9.446 1.486-6.858H8.365z","Socket","socket","Implements socket server communication between regions for the distributed application architecture","ksqfnibnsu","namespace",{"_118":119,"_90":123},"owner",{"_120":121},"githubAccount",{"_122":123},"login","patrice-truong","readmeMarkdown","redditPostExternalId","repository",{"_128":129,"_187":188,"_191":192,"_212":-5,"_213":214,"_215":-5,"_216":217},"argumentsJsonSchema",{"_130":131,"_184":185,"_135":186},"properties",{"_132":133,"_137":138,"_140":141,"_145":146,"_148":149,"_151":152,"_155":156,"_159":160,"_162":163,"_165":166,"_169":170,"_173":174,"_176":177,"_180":181},"AZURE_OPENAI_API_KEY",{"_29":134,"_135":136},"Azure OpenAI API key","type","string","AZURE_OPENAI_ENDPOINT",{"_29":139,"_135":136},"Azure OpenAI endpoint URL","AZURE_OPENAI_API_VERSION",{"_142":143,"_29":144,"_135":136},"default","2024-05-01-preview","Azure OpenAI API version","NEXT_PUBLIC_AZURE_CLIENT_ID",{"_29":147,"_135":136},"Azure client ID","NEXT_PUBLIC_AZURE_TENANT_ID",{"_29":150,"_135":136},"Azure tenant ID","AZURE_OPENAI_EMBEDDING_MODEL",{"_142":153,"_29":154,"_135":136},"text-embedding-3-small","Azure OpenAI embedding model name","AZURE_COSMOSDB_NOSQL_DATABASE",{"_142":157,"_29":158,"_135":136},"eshop","Azure Cosmos DB database name","AZURE_COSMOSDB_NOSQL_ENDPOINT",{"_29":161,"_135":136},"Azure Cosmos DB NoSQL endpoint URL","NEXT_PUBLIC_AZURE_CLIENT_SECRET",{"_29":164,"_135":136},"Azure client secret","AZURE_COSMOSDB_NOSQL_CARTS_CONTAINER",{"_142":167,"_29":168,"_135":136},"carts","Azure Cosmos DB carts container name","AZURE_COSMOSDB_NOSQL_ORDERS_CONTAINER",{"_142":171,"_29":172,"_135":136},"orders","Azure Cosmos DB orders container name","NEXT_PUBLIC_AZURE_STORAGE_ACCOUNT_NAME",{"_29":175,"_135":136},"Azure Storage account name","AZURE_COSMOSDB_NOSQL_PRODUCTS_CONTAINER",{"_142":178,"_29":179,"_135":136},"products","Azure Cosmos DB products container name","NEXT_PUBLIC_AZURE_STORAGE_CONTAINER_NAME",{"_142":182,"_29":183,"_135":136},"img","Azure Storage container name for images","required",[159,148,145,162,173,137,132],"object","githubProject",{"_33":34,"_189":190},"url","https://github.com/patrice-truong/cosmosdb-mcp","githubRepository",{"_193":194,"_195":196,"_197":198,"_16":199,"_200":201,"_31":202,"_118":203,"_205":206,"_207":208,"_210":211},"defaultBranch","main","fullName","patrice-truong/cosmosdb-mcp","githubTreeId",342302,8382,"language","TypeScript","cosmosdb-mcp",{"_122":123,"_93":204},"iyiYjyDg3s","recentStargazers",0,"spdxLicense",{"_31":209},"MIT License","stargazers",1,"glamaJson","inspectable",false,"npmPackage","supportedPlatforms",[218],"WINDOWS","scores",{"_221":222,"_223":-5,"_224":-5},"license",100,"quality","security","simpleIcon","toolCount","dtf38p20zp","updatedAt","2025-10-01T13:02:12.267508Z","meta",[232,235,237,244,247,249,252,255,258,261,264,266,269,272,274,276,278,280,282],{"_233":234},"title","Azure Cosmos DB MCP Server | Glama",{"_236":30,"_31":29},"content",{"_238":239,"_240":241,"_242":243},"href","https://glama.ai/mcp/servers/@patrice-truong/cosmosdb-mcp","rel","canonical","tagName","link",{"_236":32,"_245":246},"property","og:title",{"_236":30,"_245":248},"og:description",{"_236":250,"_245":251},"https://glama.ai/logo.png","og:logo",{"_236":253,"_245":254},"https://glama.ai/mcp/servers/@patrice-truong/cosmosdb-mcp/og-image","og:image",{"_236":256,"_245":257},"630","og:image:height",{"_236":259,"_245":260},"1200","og:image:width",{"_236":262,"_245":263},"website","og:type",{"_236":239,"_245":265},"og:url",{"_236":267,"_245":268},"Glama – MCP Hosting Platform","og:site_name",{"_236":270,"_31":271},"summary_large_image","twitter:card",{"_236":267,"_31":273},"twitter:title",{"_236":30,"_31":275},"twitter:description",{"_236":253,"_31":277},"twitter:image",{"_236":256,"_31":279},"twitter:image:height",{"_236":259,"_31":281},"twitter:image:width",{"_283":284},"script:ld+json",{"_285":286,"_287":288},"@context","http://schema.org","@graph",[289],{"_285":290,"_291":292,"_293":294},"https://schema.org","@type","BreadcrumbList","itemListElement",[295,301,305,309],{"_291":296,"_297":298,"_31":299,"_300":211},"ListItem","item","/","Glama","position",{"_291":296,"_297":302,"_31":303,"_300":304},"/mcp","MCP",2,{"_291":296,"_297":306,"_31":307,"_300":308},"/mcp/servers","Servers",3,{"_291":296,"_297":310,"_31":32,"_300":311},"/mcp/servers/@patrice-truong/cosmosdb-mcp",4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_315":316,"_27":322,"_360":361,"_230":375,"_372":399,"_400":401},"blob",{"_236":317,"_318":319,"_320":321},"\n \n Exe\n net9.0\n \n \n \n \n \n \n \n \n \n","fileName","populate.csproj","size",630,{"_69":70,"_13":323,"_79":30,"_80":30,"_16":81,"_82":324,"_31":32,"_116":333,"_124":-5,"_125":-5,"_126":336,"_219":359,"_225":-5,"_90":202,"_226":206,"_93":227,"_228":229},[72,73,74,75,76,77,78],[325,327,329,331],{"_85":326,"_29":92,"_93":94},{"_87":88,"_31":89,"_90":91},{"_85":328,"_29":100,"_93":101},{"_87":97,"_31":98,"_90":99},{"_85":330,"_29":107,"_93":108},{"_87":104,"_31":105,"_90":106},{"_85":332,"_29":114,"_93":115},{"_87":111,"_31":112,"_90":113},{"_118":334,"_90":123},{"_120":335},{"_122":123},{"_128":337,"_187":354,"_191":355,"_212":-5,"_213":214,"_215":-5,"_216":358},{"_130":338,"_184":353,"_135":186},{"_132":339,"_137":340,"_140":341,"_145":342,"_148":343,"_151":344,"_155":345,"_159":346,"_162":347,"_165":348,"_169":349,"_173":350,"_176":351,"_180":352},{"_29":134,"_135":136},{"_29":139,"_135":136},{"_142":143,"_29":144,"_135":136},{"_29":147,"_135":136},{"_29":150,"_135":136},{"_142":153,"_29":154,"_135":136},{"_142":157,"_29":158,"_135":136},{"_29":161,"_135":136},{"_29":164,"_135":136},{"_142":167,"_29":168,"_135":136},{"_142":171,"_29":172,"_135":136},{"_29":175,"_135":136},{"_142":178,"_29":179,"_135":136},{"_142":182,"_29":183,"_135":136},[159,148,145,162,173,137,132],{"_33":34,"_189":190},{"_193":194,"_195":196,"_197":198,"_16":199,"_200":201,"_31":202,"_118":356,"_205":206,"_207":357,"_210":211},{"_122":123,"_93":204},{"_31":209},[218],{"_221":222,"_223":-5,"_224":-5},"member",{"_362":363,"_366":367,"_368":369,"_197":370,"_371":214,"_372":319,"_373":374,"_320":321,"_135":315},"commit",{"_364":365},"sha","8f1dab4b8b348231296f940f861487cd3543447b","contentStoredObjectPointerId",446868,"fullPath","populate/populate.csproj",342301,"indexable","path","safeToDisplayAsText",true,[376,378,380,382,384,385,386,388,389,390,391,392,393,394,395,396,397,398],{"_233":377},"populate.csproj | Azure Cosmos DB MCP Server | Glama",{"_236":379,"_31":29},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_238":381,"_240":241,"_242":243},"https://glama.ai/mcp/servers/@patrice-truong/cosmosdb-mcp/blob/8f1dab4b8b348231296f940f861487cd3543447b/populate",{"_236":383,"_245":246},"populate.csproj | Azure Cosmos DB MCP Server",{"_236":379,"_245":248},{"_236":250,"_245":251},{"_236":387,"_245":254},"https://glama.ai/generated-images/og?title=populate.csproj+%7C+Azure+Cosmos+DB+MCP+Server",{"_236":256,"_245":257},{"_236":259,"_245":260},{"_236":262,"_245":263},{"_236":381,"_245":265},{"_236":267,"_245":268},{"_236":270,"_31":271},{"_236":267,"_31":273},{"_236":379,"_31":275},{"_236":387,"_31":277},{"_236":256,"_31":279},{"_236":259,"_31":281},"populate","treeMembers",[402,406,408,412,416],{"_362":403,"_368":404,"_372":405,"_135":315},{"_364":365},"populate/catalog.json","catalog.json",{"_362":407,"_368":369,"_372":319,"_135":315},{"_364":365},{"_362":409,"_368":410,"_372":411,"_135":315},{"_364":365},"populate/product.cs","product.cs",{"_362":413,"_368":414,"_372":415,"_135":315},{"_364":365},"populate/program.cs","program.cs",{"_362":417,"_368":418,"_372":419,"_135":315},{"_364":365},"populate/set_rbac.ps1","set_rbac.ps1","actionData","errors"]

MCP directory API