Demo

1# Demo
2![MCP Server Demo](./assets/mcp%20server.gif)
3 
4# Flow
5![Request Flow](./assets/Flow.png)
6 
7 
8# Azure Resource Graph MCP Server
9 
10This is a Model Context Protocol (MCP) server that provides access to Azure Resource Graph queries. It allows you to retrieve information about Azure resources across your subscriptions using Resource Graph queries.
11<a href="https://glama.ai/mcp/servers/@hardik-id/azure-resource-graph-mcp-server">
12  <img width="380" height="200" src="https://glama.ai/mcp/servers/@hardik-id/azure-resource-graph-mcp-server/badge" />
13</a>
14 
15[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/hardik-id-azure-resource-graph-mcp-server-badge.png)](https://mseep.ai/app/hardik-id-azure-resource-graph-mcp-server)
16 
17## Features
18 
19- Query Azure resources using Resource Graph queries
20- Default query returns resource ID, name, type, and location
21- Supports custom Resource Graph queries
22- Uses Azure DefaultAzureCredential for authentication
23 
24## Prerequisites
25 
26- Node.js installed
27- Azure subscription
28- Azure CLI installed and logged in, or other Azure credentials configured
29 
30## Running the MCP Server
31 
32You can run the MCP server using either Cursor IDE or Visual Studio Code.
33 
34### Option 1: Cursor IDE Integration
35 
36To integrate the MCP server with Cursor IDE:
37 
381. Clone this repository to your local machine (e.g., `C:\YOUR_WORKSPACE\azure-resource-graph-mcp-server`)
392. Build the project:
40```bash 
41npm install
42npm run build
43```
443. Open Cursor Settings (JSON) and add the following configuration:
45```json
46{
47  "mcpServers": {
48    "azure-resource-graph-mcp-server": {
49      "command": "node",
50      "args": [
51        "C:\\YOUR_WORKSPACE\\azure-resource-graph-mcp-server\\build\\index.js"
52      ],
53      "env": {
54        "SUBSCRIPTION_ID": "xxxxxx-xx-xx-xx-xxxxxx"
55      },
56    }
57  }
58}
59```
60> **Note**: Make sure to update the path to match your local repository location.
61 
624. Restart Cursor IDE to apply the changes
63 
64### Option 2: VS Code Integration
65 
66To integrate the MCP server with Visual Studio Code:
67 
681. Clone this repository to your local machine
692. Build the project:
70```bash 
71npm install
72npm run build
73```
743. Open VS Code Settings (JSON) by pressing `Ctrl+Shift+P`, type "Settings (JSON)" and select "Preferences: Open User Settings (JSON)"
754. Add the following configuration:
76```json
77{
78    "mcp": {
79        "servers": {
80            "azure-resource-graph": {
81                "type": "stdio",
82                "command": "node",
83                "args": [
84                    "C:\\YOUR_WORKSPACE\\azure-resource-graph-mcp-server\\build\\index.js"
85                ],
86                "env": {
87                  "SUBSCRIPTION_ID": "xxxxxx-xx-xx-xx-xxxxxx"
88                },
89            }
90        }
91    }
92}
93```
94> **Note**: Make sure to update the path to match your local repository location.
95 
965. Save the settings.json file
976. Restart VS Code to apply the changes
98 
99The MCP server will now be available to use within VS Code with cursor integration.
100 
101## Usage
102 
103The server provides the following tool:
104 
105### query-resources
106 
107Retrieves resources and their details from Azure Resource Graph.
108 
109Parameters:
110- `subscriptionId` (optional): Azure subscription ID (defaults to configured ID)
111- `query` (optional): Custom Resource Graph query (defaults to "Resources | project id, name, type, location")
112 
113## Environment Setup
114 
1151. First, make sure you're logged in to Azure CLI by running:
116   ```bash
117   az login
118   ```
119   This step is crucial for local development as the DefaultAzureCredential will automatically use your Azure CLI credentials.
120 
1212. Set up your environment variables:
122   - Copy `.env.example` to `.env`
123   - Update `AZURE_SUBSCRIPTION_ID` in `.env` with your actual subscription ID
124   - Other variables (`AZURE_TENANT_ID`, `AZURE_CLIENT_ID`, `AZURE_CLIENT_SECRET`) are optional when using Azure CLI authentication
125 
1263. Make sure you have proper Azure credentials configured. The server uses DefaultAzureCredential which supports:
127   - Azure CLI
128   - Managed Identity
129   - Visual Studio Code credentials
130   - Environment variables
131 
1324. If using environment variables, set up:
133   - AZURE_SUBSCRIPTION_ID
134   - AZURE_TENANT_ID
135   - AZURE_CLIENT_ID
136   - AZURE_CLIENT_SECRET
137 
138## Error Handling
139 
140The server includes robust error handling for:
141- Azure client initialization failures
142- Query execution errors
143- Invalid queries or parameters
144 
145## Development
146 
147To work on this project:
148 
1491. Make changes in the `src` directory
1502. Build using `npm run build`
1513. Test your changes by running the server
152 
153## License
154This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.
155 
156