演示

流程

Azure 资源图 MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，提供对 Azure 资源图查询的访问。它允许您使用资源图查询跨订阅检索有关 Azure 资源的信息。

功能

• 使用资源图查询 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

1. 打开 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"
      },
    }
  }
}

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

1. 重启 Cursor IDE 以应用更改

选项 2：VS Code 集成

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

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

npm install
npm run build

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

{
    "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"
                },
            }
        }
    }
}

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

1. 保存 settings.json 文件
2. 重启 VS Code 以应用更改

现在，MCP 服务器将在具有光标集成的 VS Code 中可用。

使用方法

服务器提供了以下工具：

query-resources

从 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 文件中用你的实际订阅 ID 更新 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 文件。