演示

流程

Azure Resource Graph MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，提供对 Azure Resource Graph 查询的访问。它允许您使用 Resource Graph 查询检索有关跨订阅的 Azure 资源的信息。 <a href="https://glama.ai/mcp/servers/@hardik-id/azure-resource-graph-mcp-server"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@hardik-id/azure-resource-graph-mcp-server/badge" /> </a>

特性

• 使用 Resource Graph 查询查询 Azure 资源
• 默认查询返回资源 ID、名称、类型和位置
• 支持自定义 Resource Graph 查询
• 使用 Azure DefaultAzureCredential 进行身份验证

前提条件

• 已安装 Node.js
• Azure 订阅
• 已安装并登录 Azure CLI，或已配置其他 Azure 凭据

运行 MCP 服务器

您可以使用 Cursor IDE 或 Visual Studio Code 运行 MCP 服务器。

选项 1：Cursor IDE 集成

要将 MCP 服务器与 Cursor IDE 集成：

1. 将此存储库克隆到您的本地计算机（例如，C:\YOUR_WORKSPACE\azure-resource-graph-mcp-server）
2. 构建项目：

npm install
npm run build

3. 打开 Cursor 设置 (JSON) 并添加以下配置：

{
  "mcpServers": {
    "azure-resource-graph-mcp-server": {
      "command": "node",
      "args": [
        "C:\\YOUR_WORKSPACE\\azure-resource-graph-mcp-server\\build\\index.js"
      ],
      "env": {
        "SUBSCRIPTION_ID": "xxxxxx-xx-xx-xx-xxxxxx"
      },
    }
  }
}

注意: 确保更新路径以匹配您的本地存储库位置。

4. 重新启动 Cursor IDE 以应用更改

选项 2：VS Code 集成

要将 MCP 服务器与 Visual Studio Code 集成：

1. 将此存储库克隆到您的本地计算机
2. 构建项目：

npm install
npm run build

3. 按 Ctrl+Shift+P 打开 VS Code 设置 (JSON)，键入 "Settings (JSON)" 并选择 "Preferences: Open User Settings (JSON)"
4. 添加以下配置：

{
    "mcp": {
        "servers": {
            "azure-resource-graph": {
                "type": "stdio",
                "command": "node",
                "args": [
                    "C:\\YOUR_WORKSPACE\\azure-resource-graph-mcp-server\\build\\index.js"
                ],
                "env": {
                  "SUBSCRIPTION_ID": "xxxxxx-xx-xx-xx-xxxxxx"
                },
            }
        }
    }
}

注意: 确保更新路径以匹配您的本地存储库位置。

5. 保存 settings.json 文件
6. 重新启动 VS Code 以应用更改

现在，MCP 服务器可以在 VS Code 中使用，并具有光标集成。

用法

该服务器提供以下工具：

query-resources

从 Azure Resource Graph 检索资源及其详细信息。

参数：

• subscriptionId（可选）：Azure 订阅 ID（默认为配置的 ID）
• query（可选）：自定义 Resource Graph 查询（默认为 "Resources | project id, name, type, location"）

环境设置

1. 首先，请确保您已登录到 Azure CLI，方法是运行：

   az login
   

   此步骤对于本地开发至关重要，因为 DefaultAzureCredential 将自动使用您的 Azure CLI 凭据。

2. 设置您的环境变量：

   • 将 .env.example 复制到 .env
   • 使用您的实际订阅 ID 更新 .env 中的 AZURE_SUBSCRIPTION_ID
   • 使用 Azure CLI 身份验证时，其他变量（AZURE_TENANT_ID、AZURE_CLIENT_ID、AZURE_CLIENT_SECRET）是可选的

3. 确保您已配置正确的 Azure 凭据。该服务器使用 DefaultAzureCredential，它支持：

   • Azure CLI
   • 托管标识
   • Visual Studio Code 凭据
   • 环境变量

4. 如果使用环境变量，请设置：

   • AZURE_SUBSCRIPTION_ID
   • AZURE_TENANT_ID
   • AZURE_CLIENT_ID
   • AZURE_CLIENT_SECRET

错误处理

该服务器包括强大的错误处理功能，用于处理：

• Azure 客户端初始化失败
• 查询执行错误
• 无效的查询或参数

开发

要开发此项目：

1. 在 src 目录中进行更改
2. 使用 npm run build 构建
3. 通过运行服务器测试您的更改

许可证

此项目已获得 MIT 许可证的许可。有关详细信息，请参阅 LICENSE 文件。