Azure Utils MCP

Azure Utils MCP服务器

用于Azure开发和运营的MCP（模型上下文协议）服务器。兼容任何MCP客户端——Claude Code、Claude Desktop、Cursor等。

涵盖三个方面：

• Cosmos数据库 --列出帐户、数据库和容器；运行SQL查询；读取、写入和删除文档
• 服务总线 --列出名称空间、队列和主题；发送消息；查看、清除和重新排队死信队列
• 授权/PIM --列出符合条件的角色并激活PIM角色分配

身份验证使用 DefaultAzureCredential，它会拾取一个活动 az login 会话自动。可选地，可以通过环境变量使用基于Cosmos DB密钥的身份验证和服务总线连接字符串身份验证（请参见 认证 在......下面

需求

• 紫外线
• Azure命令行界面 与活跃 az login 会话

安装

macOS

brew install uv azure-cli

Linux

curl -LsSf https://astral.sh/uv/install.sh | sh
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash   # Debian/Ubuntu

有关其他Linux发行版，请参阅 Azure CLI安装文档.

视窗

winget install --id=astral-sh.uv
winget install --id=Microsoft.AzureCLI

配置

克劳德代码 用户：

claude mcp add --scope user azure-utils -- uvx azure-utils-mcp

对于其他MCP客户端，请在服务器配置中添加以下内容：

{
  "mcpServers": {
    "azure-utils": {
      "command": "uvx",
      "args": ["azure-utils-mcp"]
    }
  }
}

添加服务器后重新启动MCP客户端。

从源代码安装

git clone https://github.com/BrianDeacon/azure-utils-mcp
cd azure-utils-mcp
uv sync
az login

然后使用克隆的路径进行配置：

{
  "mcpServers": {
    "azure-utils": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/azure-utils-mcp", "azure-utils-mcp"]
    }
  }
}

______________________________________________________________________

认证

所有工具默认为 DefaultAzureCredential，它会拾取一个活动 az login 会话、托管身份或其他标准Azure凭据源。

对于Cosmos DB和Service Bus，您可以通过设置环境变量来选择使用基于密钥或连接字符串的身份验证。每个工具都接受一个可选参数来指定从哪个环境变量读取，并具有合理的默认值：

如果设置了指定的环境变量，则其值将用于身份验证。如果不是， DefaultAzureCredential 被用作后备方案。

这种设计允许您通过重写env var名称将不同的工具调用指向不同的凭据。例如，您可以使用 MY_DEV_COSMOS_KEY 对于一个帐户和 MY_PROD_COSMOS_KEY 另一方面，保持两者在你的环境中没有冲突。

其他环境变量：

• AZURE_SUBSCRIPTION_ID --被使用 list_accounts / list_namespaces 如果设置；否则，从 az login

______________________________________________________________________

Cosmos数据库工具

这 account 参数接受短帐户名（例如。 my-cosmos-account)或完整的端点URL https:// 前缀和 .documents.azure.com 如果缺少后缀，则会自动添加。

所有Cosmos DB数据平面工具（除 cosmosdb_list_accounts)接受可选 key_env_var 参数（默认值 AZURE_COSMOS_KEY).看 认证.

cosmosdb_list_accounts

列出当前Azure订阅中的所有Cosmos DB帐户。

cosmosdb_list_databases

cosmosdb_list_containers

cosmosdb_get_container_info

返回分区键路径、索引策略、默认TTL、唯一键策略和系统属性。

cosmosdb_query_items

cosmosdb_query_items_to_file

同 cosmosdb_query_items 而是将结果写入文件。当结果集可能很大时使用。

cosmosdb_count_items

cosmosdb_read_item

cosmosdb_upsert_item

cosmosdb_delete_item

破坏性的。

______________________________________________________________________

服务总线工具

这 namespace 参数接受短名称（例如。 my-namespace)或完全限定的主机名。这 .servicebus.windows.net 如果缺少后缀，则会自动附加后缀。

所有服务总线数据平面工具（除 servicebus_list_namespaces)接受可选 connection_string_env_var 参数（默认值 AZURE_SERVICEBUS_CONNECTION_STRING).看 认证.

servicebus_list_namespaces

列出当前Azure订阅中的所有Service Bus命名空间。

servicebus_list_queues

servicebus_list_topics

servicebus_send_message

servicebus_send_batch

servicebus_peek_messages / servicebus_peek_messages_to_file

servicebus_peek_dlq / servicebus_peek_dlq_to_file

servicebus_purge_queue / servicebus_purge_dlq

破坏性的。

servicebus_requeue_dlq

servicebus_peek_subscription_messages / servicebus_peek_subscription_messages_to_file

servicebus_peek_subscription_dlq / servicebus_peek_subscription_dlq_to_file

servicebus_purge_subscription / servicebus_purge_subscription_dlq

破坏性的。

servicebus_requeue_subscription_dlq

______________________________________________________________________

授权/PIM工具

authorization_list_eligible_roles

列出您有资格在所有可访问的订阅中激活的所有Azure PIM角色。返回角色名称、范围以及资格是永久的还是有时间限制的。

authorization_activate_role

返回激活状态和请求ID。 Provisioned 指立即激活； PendingApproval 意味着审批人必须首先采取行动。

______________________________________________________________________

安全

• 身份验证默认为 DefaultAzureCredential.当通过环境变量使用基于键或连接字符串的身份验证时，只有env var *名字* 作为工具参数传递，而不是秘密值本身。
• purge_* 和 requeue_* 工具强制执行 max_messages 安全帽，防止意外批量操作。
• cosmosdb_delete_item 是一个需要项目ID和分区密钥的硬点删除。