Azure MCP Server

🚀 Azure MCP サーバー

このサーバーは、Azure の MCP (Multi-Cloud Provider) プロトコルを実装しており、以下のサービスをサポートしています。

• Azure Blob Storage：オブジェクトストレージ内のデータの保存と管理に使用します。
• Azure Cosmos DB：グローバルに分散された NoSQL データベースサービスで、高い拡張性とパフォーマンスを提供します。
• Azure App Configuration：アプリケーションの設定を管理および構成するために使用します。

🚀 クイックスタート

この Azure MCP サーバーは、Azure の MCP プロトコルを実装し、複数の Azure サービスをサポートしています。以下のセクションでは、インストール、設定、操作方法について説明します。

📦 インストール

1. Smithay を使用したインストール

Smithay を使用して開発している場合は、以下の手順に従ってください。

smithay new Azure-MCP-Server --type=mcp
cd Azure-MCP-Server
# src/main.rs 内に以下の内容を追加し、YOUR_SUBSCRIPTION_ID と YOUR_RESOURCE_GROUP を実際の値に置き換えてください

2. 手動インストール

Smithay を使用していない場合は、以下の手順で手動インストールしてください。

1. Rust と関連する依存関係をインストールします。
2. このリポジトリをクローンします。

git clone https://github.com/your-repository/Azure-MCP-Server.git
cd Azure-MCP-Server
cargo build

📚 ドキュメント

設定ガイド

1. データベースとコンテナの作成

Azure ポータルで以下のリソースを作成します。

• データベース：SampleDB という名前で作成します。
• コンテナ：sample-container という名前で作成し、パーティションキー（例：/partitionKey）を指定します。

2. サンプルデータの挿入

以下の Python スクリプトを使用して、いくつかのサンプルデータを挿入します。

from azure.cosmos import CosmosClient, PartitionKey

# Cosmos クライアントを初期化します
client = CosmosClient('your-endpoint', 'your-key')

# データベースとコンテナの参照を取得します
db = client.get_database_client("SampleDB")
container = db.get_container_client("sample-container")

# サンプルデータを挿入します
item1 = {
    "id": "item1",
    "partitionKey": "分区键值1",
    "name": "Item 1"
}
container.upsert_item(item1)

item2 = {
    "id": "item2",
    "partitionKey": "分区键值2",
    "name": "Item 2"
}
container.upsert_item(item2)

ツール操作

Blob Storage 操作

• Blob の作成：ファイルをストレージアカウントにアップロードします。
• Blob の読み取り：ストレージアカウントからファイルをダウンロードします。
• Blob の削除：指定された Blob ファイルを削除します。

Cosmos DB 操作

コンテナ管理

• コンテナの作成：

  /path/to/mcp-cli create_cosmos_container --container_name sample-container --partition_key "/partitionKey" [--database_name SampleDB]
  

• コンテナの説明：

  /path/to/mcp-cli describe_cosmos_container --container_name sample-container [--database_name SampleDB]
  

• コンテナの一覧表示：

  /path/to/mcp-cli list_cosmos_containers [--database_name SampleDB]
  

• コンテナの削除：

  /path/to/mcp-cli delete_cosmos_container --container_name sample-container [--database_name SampleDB]
  

ドキュメント管理

• ドキュメントの作成：

  /path/to/mcp-cli create_cosmos_document --container_name sample-container --document '{"id": "new-item", "partitionKey": "new-key", "name": "New Item"}' [--database_name SampleDB]
  

• ドキュメントの読み取り：

  /path/to/mcp-cli get_cosmos_document --container_name sample-container --document_id new-item [--database_name SampleDB]
  

• ドキュメントの更新：

  /path/to/mcp-cli update_cosmos_document --container_name sample-container --document_id new-item --update_mask '{"name": "New Item Updated"}' [--database_name SampleDB]
  

• ドキュメントの削除：

  /path/to/mcp-cli delete_cosmos_document --container_name sample-container --document_id new-item [--database_name SampleDB]
  

App Configuration 操作

• 設定値の取得：

  /path/to/mcp-cli get_app_configuration --key my-config-key
  

• 設定値の設定：

  /path/to/mcp-cli set_app_configuration --key my-config-key --value my-config-value
  

⚠️ 重要注意事項

1. Cosmos DB を使用する際は、正しいパーティションキーを指定してください。そうしないと、パフォーマンス上の問題が発生する可能性があります。
2. Cosmos DB は大文字と小文字を区別するため、フィールド名の大文字と小文字に注意してください。
3. デフォルトのデータベースは SampleDB です。他のデータベースを使用する場合は、コマンド内で --database_name を明示的に指定してください。