示例

流程

Azure 资源图 MCP 服务器

这是一个提供访问 Azure 资源图查询的模型上下文协议（MCP）服务器。它允许您使用资源图查询跨订阅检索有关 Azure 资源的信息。 <a href="https://glama.ai/mcp/servers/@hardik-id/azure-resource-graph-mcp-server"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=2695329814,3537218589&fm=3081&app=3081&f=PNG?w=760&h=400" /> </a>

功能

• 使用资源图查询查询 Azure 资源
• 默认查询返回资源ID、名称、类型和位置
• 支持自定义资源图查询
• 使用 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. 打开 VS Code 设置（JSON），按 Ctrl+Shift+P，键入“设置（JSON）”并选择“首选项：打开用户设置（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 中通过 Cursor 集成可用。

使用方法

该服务器提供了以下工具：

查询资源

从 Azure 资源图中检索资源及其详细信息。

参数：

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

环境设置

1. 首先，确保您已通过运行以下命令登录到 Azure CLI：

   az login
   

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

2. 设置环境变量：

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

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 文件。