Azure MCP Server

🚀 Azure MCP 服務器

這是一個實現 Azure 的 MCP (Multi-Cloud Provider) 協議的服務器，支持 Azure Blob Storage、Azure Cosmos DB 和 Azure App Configuration 服務，可用於存儲管理數據、提供數據庫服務以及管理應用程序設置。

🚀 快速開始

本服務器實現了 Azure 的 MCP 協議，支持多種 Azure 服務。你可以按照以下步驟進行安裝和配置。

✨ 主要特性

• Azure Blob Storage：用於存儲和管理對象存儲中的數據。
• Azure Cosmos DB：一個全球化分佈的 NoSQL 數據庫服務，提供高擴展性和高性能。
• Azure App Configuration：用於管理和配置應用程序設置。

📦 安裝指南

使用 Smithay 進行安裝

如果你已經使用 Smithay 進行開發，請按照以下步驟操作：

smithay new Azure-MCP-Server --type=mcp
cd Azure-MCP-Server
# 在 src/main.rs 中添加以下內容，將 YOUR_SUBSCRIPTION_ID 和 YOUR_RESOURCE_GROUP 替換為你的實際值

手動安裝

如果你沒有使用 Smithay，請按照以下步驟手動安裝：

1. 安裝 Rust 和相關依賴。
2. 克隆此倉庫：

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

📚 詳細文檔

配置指南

創建數據庫和容器

在 Azure 門戶中創建以下資源：

• 數據庫：命名為 SampleDB。
• 容器：命名為 sample-container，並指定分區鍵（例如 /partitionKey）。

插入示例數據

使用以下 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。