Skip to main content
Glama
enesjakozh
patrice-truong

Azure Cosmos DB MCP Server

by patrice-truong
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Azure Cosmos DB MCP クライアント & サーバー

このリポジトリには、Azure Cosmos DB 用の MCP サーバーとクライアントの作成方法を示すプロジェクトが含まれています。このプロジェクトは 2 つの部分に分かれています。

  • フロントエンドアプリケーション: 製品カタログを表示し、ユーザーがカタログ内の製品を見つけて過去の注文を取得するのに役立つ AI アシスタントを備えた NextJS 15 アプリケーション

  • Azure Cosmos DB NoSQL データベースに接続され、データベースから製品と注文を読み取る役割を担う MCP サーバー コンポーネント。

デモ

Azure アーキテクチャ

  • 製品カタログを保存する Azure Cosmos DB NoSQL データベース

  • MCP サーバー コンポーネントとして機能する Node.js サーバー

Related MCP server: Azure Cosmos DB MCP Server

参考文献

ステップバイステップのウォークスルー

インストール

Azure Cosmos DB

Azure ポータルで、Azure Cosmos DB for NoSQL アカウントを作成します。

  • Azure Cosmos DB アカウントに一意の名前を付けます。このチュートリアルの残りの部分では、cosmos-eastus2-nosql-2 を使用します。

Cosmos DB - 基礎

  • 「次へ: グローバル配布」をクリックします

Cosmos DB - グローバル配信

  • デフォルト値を受け入れて、「次へ: ネットワーク」をクリックします。

Cosmos DB - ネットワーク

  • デフォルト値を受け入れて、「次へ: バックアップポリシー」をクリックします。

  • 「定期」バックアップポリシーを選択する

  • 「ローカル冗長バックアップストレージ」を選択します

Cosmos DB - バックアップポリシー

  • 「次へ: 暗号化」をクリックします

Cosmos DB - 暗号化

  • 「確認と作成」をクリックして検証を開始します

Cosmos DB - 検証

  • 「作成」をクリックして、Azure Cosmos DB for NoSQL アカウントの作成を開始します。

このプロジェクトでは、Azure Cosmos DB アカウントでベクター サポートを有効にする必要があります。

  • 設定セクションで、「機能」を選択し、「Vector Search for NoSQL API」を選択します。

  • 開いたパネルで、「有効にする」ボタンをクリックします。

Cosmos DB - 検証

  • Azure Cosmos DB eShop データベースと製品コンテナーを作成する

  • eShop の横にある「...」をクリックしてコンテキスト メニューを表示し、「新しいコンテナー」を選択して、eShop データベースに「カート」コンテナーを作成します。

パーティションキーが***「/id」***であることを確認してください（パーティションキーでは大文字と小文字が区別されます）

「コンテナベクターポリシー」を展開し、「ベクター埋め込みを追加」ボタンをクリックします。

Cosmos DB - データベースの作成

  • カートコンテナを作成する

Cosmos DB - データベースの作成

ストレージアカウント

  1. 製品画像を保存するためのストレージアカウントを作成する

詳細については、次のドキュメントを参照してください: https://learn.microsoft.com/en-us/azure/storage/common/storage-account-create?tabs=azure-portal

ストレージ - 基本

ストレージ - 高度

ストレージ - ネットワーク

ストレージ - データ保護

ストレージ - 暗号化

保管 - 検証

**ソフトウェアの前提条件をインストールする**

  1. Azureで仮想マシンを作成するか、ローカルコンピューターを使用する

  2. https://nodejs.org/en/downloadから node.js v22.13.1 (LTS) をインストールします。

  3. https://code.visualstudio.com/downloadから Visual Studio Code x64 1.97.0 をインストールします。

  4. https://git-scm.com/downloadsから Git 2.47.12 x64 をインストールします。

  5. https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-9.0.102-windows-x64-installerから .NET SDK x64 v9.0.102 をインストールします。

  6. ターミナルウィンドウを開き、NuGetソースを追加します。

dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org

  1. 必要に応じて、WindowsコンピュータのPowerShell実行ポリシーを変更します。管理者モードでPowerShellウィンドウを開き、次のコマンドを実行します。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

  1. 必要に応じて、NuGet、PowerShell、az cli、azモジュールをインストールします。

# install az cli winget install -e --id Microsoft.AzureCLI # install nuget and reference nuget source Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force # update to latest Powershell release (7.5 as of writing) winget install --id Microsoft.PowerShell --source winget # install az modules Install-Module -Name Az -Repository PSGallery -Force -AllowClobber

  1. ターミナル ウィンドウを開き、リポジトリのクローンを作成します。

git clone https://github.com/patrice-truong/cosmosdb-mcp.git cd cosmosdb-mcp

  1. nextjsフォルダに移動して依存関係をインストールします

cd cosmosdb-mcp/nextjs npm install --legacy-peer-deps

  1. nextjs フォルダーで、次の値を持つ .env ファイルを作成して構成します。

AZURE_COSMOSDB_NOSQL_ENDPOINT=https://<cosmosdb_account_name>.documents.azure.com:443/ AZURE_COSMOSDB_NOSQL_DATABASE=eshop AZURE_COSMOSDB_NOSQL_PRODUCTS_CONTAINER=products AZURE_COSMOSDB_NOSQL_CARTS_CONTAINER=carts AZURE_COSMOSDB_NOSQL_ORDERS_CONTAINER=orders AZURE_STORAGE_ACCOUNT_NAME=<storage_account_name> AZURE_STORAGE_CONTAINER_NAME=<container_name>

  1. テナントIDを取得します。テナントIDは次のコマンドで取得できます。

az login az account show --query tenantId -o tsv

  1. webapi フォルダーで、appsettings.json ファイルを構成し、tenant_id を前の手順で取得した値に置き換えます。

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

  1. Azure ポータルでアプリ登録を作成する

  2. Azureポータルでアプリシークレットを作成する

  3. アプリにAzure Cosmos DBへのアクセスを許可する必要があります。以下の4つのIDを取得し、「populate/set_rbac.ps1」ファイルを変更してください。

変数

参照

サブスクリプションID

Cosmos DB > 概要 > サブスクリプション ID

Azure Cosmos DB アカウント名

コスモス-eastus2-nosql-2

リソースグループ名

Cosmos DB > 概要 > リソースグループ名

プリンシパルID

アプリ登録オブジェクトID

$SubscriptionId = "<subscription-id>" # Azure subscription id $AccountName = "<cosmosdb-account-name>" # cosmos db account name $ResourceGroupName = "<resource-group-name>" # resource group name of the Cosmos DB account $PrincipalId = "<principal-id>" # object id of the app registered in Entra ID

  1. Powershellプロンプトを開き、Connect-AzAccountを実行して、./set_rbac.ps1を実行します。

Cosmos DB - RBAC

  1. アプリ（または仮想マシン）がストレージ アカウントにアクセスできるようにします

  • Azureポータルでストレージアカウントに移動します

  • メニューでアクセス制御（IAM）を選択します

ストレージ - アクセス制御

  • 「役割の割り当てを追加」をクリックします

  • フィルターテキストボックスに「Storage Blob Data Contributor」と入力します

ストレージ - Blob データ コントリビューター

  • 「メンバー」をクリック

  • アプリケーションの名前を選択してください

ストレージ - 役割の割り当て

  • 「選択」ボタンをクリックします

  • 「確認して割り当てる」をクリックします

ストレージ - 役割の割り当て

  1. コンテナを作成し、「azure-storage」フォルダの内容をストレージアカウントにコピーします。

ストレージ - コンテナの作成

ストレージ - ファイルのアップロード

ストレージ - アップロードされたファイル

  1. dotnet build で WebAPI バックエンド プロジェクトをビルドする

cd webapi dotnet build

ドットネットビルド 18. セカンダリリージョンVM（オーストラリア東部）で、プライマリリージョン（米国東部2）のソケットサーバーのIPアドレスを使用して.envファイルを変更します。

ソケットサーバーのIP

  1. このプロジェクトには認証機能が組み込まれていません。ユーザーのメールアドレスは/nextjs/models/constants.tsにハードコードされています。デモのニーズに合わせて変更してください。

npm 実行ビルド

  1. mcp-server と nextjs フォルダで、.env.template を .env にコピーし、デモのニーズに合わせて値を変更します。

AZURE_COSMOSDB_NOSQL_ENDPOINT=https://<cosmosdb_account>.documents.azure.com:443/ AZURE_COSMOSDB_NOSQL_DATABASE=eshop AZURE_COSMOSDB_NOSQL_PRODUCTS_CONTAINER=products AZURE_COSMOSDB_NOSQL_CARTS_CONTAINER=carts AZURE_COSMOSDB_NOSQL_ORDERS_CONTAINER=orders NEXT_PUBLIC_AZURE_TENANT_ID=<tenant_id> NEXT_PUBLIC_AZURE_CLIENT_ID=<client_id> NEXT_PUBLIC_AZURE_CLIENT_SECRET=<client_secret> NEXT_PUBLIC_AZURE_STORAGE_ACCOUNT_NAME=<storage_account_name> NEXT_PUBLIC_AZURE_STORAGE_CONTAINER_NAME=img AZURE_OPENAI_ENDPOINT=https://<azure_openai_account>.openai.azure.com/ AZURE_OPENAI_API_KEY=<azure_openai_key> AZURE_OPENAI_EMBEDDING_MODEL=text-embedding-3-small AZURE_OPENAI_API_VERSION=2024-05-01-preview

  1. Nextjsフロントエンドプロジェクトをビルドする

cd nextjs npm run build

npm 実行ビルド

製品カタログに情報を追加する

このセクションでは、populate/catalog.json ファイルから製品カタログを読み取り、Azure Cosmos DB for NoSQL データベースに入力します。

  1. appsettings.jsonをcosmosdbアカウント名に変更し、

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

  1. ターミナルウィンドウを開き、populateフォルダに移動し、az loginを実行してからdotnet runを実行します。

Cosmos - Populate製品

  1. Azure Cosmos DB コンテナーが適切に設定されていることを確認します

コスモス - 製品

デモスクリプト

デモの初期化:

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

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

  1. フロントエンドプロジェクトを開始する

  • NextJS フロントエンド（ストアフロント）

    • cd nextjs

    • npm スタート

  1. オプションとして、コマンドプロンプトを開き、次のコマンドでMCPインスペクターを起動します: npx -y @modelcontextprotocol/inspector

デモの手順:

  1. http://localhost:3002に移動します。

  2. 右上隅のAIアシスタントアイコンをクリックします

  3. 「バックパックに興味があります」と入力します（商品リストが更新され、バックパックのリストが表示されます）

  4. 「注文を取得」と入力します（注文リストが更新されます）

デモ

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/patrice-truong/cosmosdb-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server