Azure MCP 服务器

概述

这是一个实现 Azure 的 MCP (Multi-Cloud Provider) 协议的服务器，支持以下服务：

• Azure Blob Storage：用于存储和管理对象存储中的数据。
• Azure Cosmos DB：一个全球化分布的 NoSQL 数据库服务，提供高扩展性和高性能。
• Azure App Configuration：用于管理和配置应用程序设置。

安装指南

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。

完整的 README 翻译

以下是完整的 README 文档翻译：

Azure MCP 服务器

这是一个实现 Azure 多云协议 (MCP) 的服务器，支持以下服务：

• Azure Blob Storage：用于存储和管理对象存储。
• Azure Cosmos DB：全球化分布的 NoSQL 数据库。
• Azure App Configuration：管理和配置应用程序设置。

安装指南

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