@north7/entraaware 0.0.1 → 0.0.2

package/README.md

@@ -36,7 +36,7 @@ Create a `.mcp.json` file in your VS Code workspace:
       "command": "npx",
       "args": [
         "-y",
-        "@uniquk/entraaware@latest"
+        "@north7/entraaware@latest"
       ],
       "env": {
         "TENANT_ID": "your-tenant-id",

package/build/index.js

@@ -5,8 +5,9 @@ import { z } from "zod";
 import { Client } from "@microsoft/microsoft-graph-client";
 import { ClientSecretCredential } from "@azure/identity";
 import { TokenCredentialAuthenticationProvider } from "@microsoft/microsoft-graph-client/authProviders/azureTokenCredentials/index.js";
-// Initialize Graph Client
+// Initialize clients
 let graphClient = null;
+let azureCredential = null;
 // Create server instance
 const server = new McpServer({
     name: "EntraAware",
@@ -16,92 +17,365 @@ const server = new McpServer({
         tools: {},
     },
 });
-// Direct Microsoft Graph API access tool
-server.tool("askEntra", "Ask any question about your Microsoft Entra (Azure AD) tenant in natural language", {
-    question: z.string().describe("Your natural language question about Microsoft 365 Entra (Azure AD)")
-}, async ({ question }) => {
+// SHARED UTILITIES
+function getCredentials() {
+    const tenantId = process.env.TENANT_ID;
+    const clientId = process.env.CLIENT_ID;
+    const clientSecret = process.env.CLIENT_SECRET;
+    if (!tenantId || !clientId || !clientSecret) {
+        throw new Error("Missing required environment variables: TENANT_ID, CLIENT_ID, or CLIENT_SECRET");
+    }
+    return { tenantId, clientId, clientSecret };
+}
+function getAzureCredential() {
+    if (!azureCredential) {
+        const { tenantId, clientId, clientSecret } = getCredentials();
+        azureCredential = new ClientSecretCredential(tenantId, clientId, clientSecret);
+    }
+    return azureCredential;
+}
+function formatApiResponse(apiType, method, path, result) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: `${apiType} API Result (${method.toUpperCase()} ${path}):\n\n${JSON.stringify(result, null, 2)}`,
+            },
+        ],
+    };
+}
+function formatErrorResponse(err, apiType) {
+    const errorDetail = err instanceof Error
+        ? {
+            message: err.message,
+            name: err.name,
+            detail: apiType === 'Entra'
+                ? err.body ? JSON.stringify(err.body) : undefined
+                : err.response?.body || undefined,
+            status: err.statusCode || err.status
+        }
+        : String(err);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Error querying ${apiType} API: ${JSON.stringify(errorDetail, null, 2)}`,
+            },
+        ],
+    };
+}
+// MICROSOFT GRAPH API TOOL
+server.tool("askEntra", "Direct access to Microsoft Graph API for accurate Entra (Azure AD) data", {
+    path: z.string().describe("The Graph API URL path (e.g. '/users/{id}/memberOf', '/directoryRoles')"),
+    method: z.enum(["get", "post", "put", "patch", "delete"]).default("get").describe("HTTP method to use"),
+    queryParams: z.record(z.string()).optional().describe("Query parameters for the request"),
+    body: z.record(z.string(), z.any()).optional().describe("Request body for POST/PUT/PATCH requests"),
+    apiVersion: z.enum(["v1.0", "beta"]).default("v1.0").describe("Microsoft Graph API version"),
+    fetchAllPages: z.boolean().optional().default(false).describe("Automatically fetch all pages of results"),
+    consistencyLevel: z.string().optional().describe("ConsistencyLevel header value (use 'eventual' for queries with $filter, $search, etc.)"),
+    // Shorthand params
+    select: z.string().optional().describe("Shorthand for $select query parameter"),
+    filter: z.string().optional().describe("Shorthand for $filter query parameter"),
+    expand: z.string().optional().describe("Shorthand for $expand query parameter"),
+    orderBy: z.string().optional().describe("Shorthand for $orderBy query parameter"),
+    top: z.number().optional().describe("Shorthand for $top query parameter"),
+    count: z.boolean().optional().describe("Shorthand for $count=true to include count of items"),
+}, async ({ path, method, queryParams = {}, body, apiVersion, fetchAllPages, consistencyLevel, select, filter, expand, orderBy, top, count }) => {
     try {
-        // Get or initialize Graph client
+        // Process shorthand query parameters
+        const processedParams = { ...queryParams };
+        if (select)
+            processedParams['$select'] = select;
+        if (filter)
+            processedParams['$filter'] = filter;
+        if (expand)
+            processedParams['$expand'] = expand;
+        if (orderBy)
+            processedParams['$orderby'] = orderBy;
+        if (top !== undefined)
+            processedParams['$top'] = top.toString();
+        if (count)
+            processedParams['$count'] = 'true';
+        // Initialize or get Graph client
         if (!graphClient) {
-            graphClient = initGraphClient();
+            const credential = getAzureCredential();
+            const authProvider = new TokenCredentialAuthenticationProvider(credential, {
+                scopes: ["https://graph.microsoft.com/.default"],
+            });
+            graphClient = Client.initWithMiddleware({ authProvider });
+        }
+        // Build request with API path and version
+        let request = graphClient.api(path).version(apiVersion);
+        // Add query parameters
+        if (Object.keys(processedParams).length > 0) {
+            request = request.query(processedParams);
         }
-        // Default path if we can't determine from the question
-        let path = "/organization";
-        // Extract any email addresses or GUIDs from the question
-        const emailPattern = /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/;
-        const guidPattern = /\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/i;
-        const emailMatch = question.match(emailPattern);
-        const guidMatch = question.match(guidPattern);
-        // Check for specific keywords in the question to determine the right path
-        const lowerQuestion = question.toLowerCase();
-        if (lowerQuestion.includes("conditional access") || lowerQuestion.includes("policies")) {
-            path = "/identity/conditionalAccess/policies";
+        // Add consistency level header if provided
+        if (consistencyLevel) {
+            request = request.header('ConsistencyLevel', consistencyLevel);
         }
-        else if (lowerQuestion.includes("users") || lowerQuestion.includes("user")) {
-            path = "/users";
-            if (emailMatch) {
-                path = `/users/${emailMatch[0]}`;
+        // Handle pagination for GET requests
+        let result;
+        if (method === 'get' && fetchAllPages) {
+            const firstPage = await request.get();
+            // If no pagination needed, return first page
+            if (!firstPage["@odata.nextLink"]) {
+                result = firstPage;
+            }
+            else {
+                // Collect all items from all pages
+                const allItems = [...(firstPage.value || [])];
+                let nextLink = firstPage["@odata.nextLink"];
+                while (nextLink) {
+                    const nextPage = await graphClient.api(nextLink).get();
+                    if (nextPage.value)
+                        allItems.push(...nextPage.value);
+                    nextLink = nextPage["@odata.nextLink"] || null;
+                }
+                result = {
+                    "@odata.context": firstPage["@odata.context"],
+                    value: allItems,
+                    "@odata.count": firstPage["@odata.count"],
+                    totalItemsFetched: allItems.length
+                };
             }
         }
-        else if (lowerQuestion.includes("groups") || lowerQuestion.includes("group")) {
-            path = "/groups";
+        else {
+            // Execute appropriate method
+            switch (method) {
+                case 'get':
+                    result = await request.get();
+                    break;
+                case 'post':
+                    result = await request.post(body || {});
+                    break;
+                case 'put':
+                    result = await request.put(body || {});
+                    break;
+                case 'patch':
+                    result = await request.patch(body || {});
+                    break;
+                case 'delete':
+                    await request.delete();
+                    result = { status: "Successfully deleted" };
+                    break;
+            }
         }
-        else if (lowerQuestion.includes("applications") || lowerQuestion.includes("apps")) {
-            path = "/applications";
+        return formatApiResponse('Entra', method, path, result);
+    }
+    catch (err) {
+        return formatErrorResponse(err, 'Entra');
+    }
+});
+// AZURE RESOURCE MANAGEMENT API TOOL
+server.tool("askAzure", "Direct access to Azure Resource Management API for managing Azure resources", {
+    path: z.string().describe("The Azure API path (e.g. '/subscriptions', '/resourceGroups/{name}')"),
+    method: z.enum(["get", "post", "put", "patch", "delete"]).default("get").describe("HTTP method to use"),
+    apiVersion: z.string().optional().describe("Azure API version - required for each Azure Resource Provider"),
+    subscriptionId: z.string().optional().describe("Azure Subscription ID (if not included in path)"),
+    body: z.record(z.string(), z.any()).optional().describe("Request body for POST/PUT/PATCH requests"),
+    queryParams: z.record(z.string()).optional().describe("Additional query parameters"),
+    fetchAllPages: z.boolean().optional().default(false).describe("Automatically fetch all pages of results"),
+    // Predefined operations
+    operation: z.enum([
+        "listResources", "listResourceProviders", "getResourceProvider",
+        "registerResourceProvider", "getResourceTypes", "getApiVersions",
+        "getLocations", "createResource", "deployTemplate", "deleteResource", "custom"
+    ]).optional().default("custom").describe("Predefined Azure operations"),
+    // Parameters for predefined operations
+    providerNamespace: z.string().optional().describe("Resource provider namespace (e.g. 'Microsoft.Compute')"),
+    resourceType: z.string().optional().describe("Resource type for specific operations"),
+    resourceGroupName: z.string().optional().describe("Resource group name for resource operations"),
+    resourceName: z.string().optional().describe("Resource name for resource operations"),
+}, async ({ path, method, apiVersion, subscriptionId, body, queryParams = {}, fetchAllPages, operation = "custom", providerNamespace, resourceType, resourceGroupName, resourceName }) => {
+    try {
+        // Default API versions for common resource types
+        const defaultApiVersions = {
+            'resources': '2021-04-01',
+            'resourceGroups': '2021-04-01',
+            'subscriptions': '2021-01-01',
+            'providers': '2021-04-01',
+            'deployments': '2021-04-01',
+            'Microsoft.Compute/virtualMachines': '2023-03-01',
+            'Microsoft.Storage/storageAccounts': '2023-01-01',
+            'Microsoft.Network/virtualNetworks': '2023-04-01',
+            'Microsoft.KeyVault/vaults': '2023-02-01'
+        };
+        // Handle predefined operations
+        if (operation !== "custom") {
+            const requiredSubscriptionId = !['listResourceProviders', 'getResourceProvider', 'registerResourceProvider'].includes(operation);
+            if (requiredSubscriptionId && !subscriptionId) {
+                throw new Error(`Operation '${operation}' requires a subscriptionId`);
+            }
+            switch (operation) {
+                case 'listResources':
+                    path = resourceGroupName
+                        ? `/subscriptions/${subscriptionId}/resourceGroups/${resourceGroupName}/resources`
+                        : `/subscriptions/${subscriptionId}/resources`;
+                    apiVersion = apiVersion || defaultApiVersions['resources'];
+                    break;
+                case 'listResourceProviders':
+                    path = `/subscriptions/${subscriptionId}/providers`;
+                    apiVersion = apiVersion || defaultApiVersions['providers'];
+                    break;
+                case 'getResourceProvider':
+                    if (!providerNamespace)
+                        throw new Error("Operation 'getResourceProvider' requires a providerNamespace");
+                    path = `/subscriptions/${subscriptionId}/providers/${providerNamespace}`;
+                    apiVersion = apiVersion || defaultApiVersions['providers'];
+                    break;
+                case 'registerResourceProvider':
+                    if (!providerNamespace)
+                        throw new Error("Operation 'registerResourceProvider' requires a providerNamespace");
+                    path = `/subscriptions/${subscriptionId}/providers/${providerNamespace}/register`;
+                    method = 'post';
+                    apiVersion = apiVersion || defaultApiVersions['providers'];
+                    break;
+                case 'getResourceTypes':
+                case 'getApiVersions':
+                case 'getLocations':
+                    if (!providerNamespace)
+                        throw new Error(`Operation '${operation}' requires providerNamespace`);
+                    path = `/subscriptions/${subscriptionId}/providers/${providerNamespace}`;
+                    apiVersion = apiVersion || defaultApiVersions['providers'];
+                    break;
+                case 'createResource':
+                    if (!resourceGroupName || !providerNamespace || !resourceType || !resourceName) {
+                        throw new Error("Operation 'createResource' requires resourceGroupName, providerNamespace, resourceType, and resourceName");
+                    }
+                    if (!body)
+                        throw new Error("Operation 'createResource' requires a request body");
+                    path = `/subscriptions/${subscriptionId}/resourceGroups/${resourceGroupName}/providers/${providerNamespace}/${resourceType}/${resourceName}`;
+                    method = 'put';
+                    const providerResourceKey = `${providerNamespace}/${resourceType}`;
+                    apiVersion = apiVersion || defaultApiVersions[providerResourceKey] || '2021-04-01';
+                    break;
+                case 'deployTemplate':
+                    if (!resourceGroupName)
+                        throw new Error("Operation 'deployTemplate' requires resourceGroupName");
+                    if (!body?.properties?.template)
+                        throw new Error("Operation 'deployTemplate' requires a template in the body");
+                    const deploymentName = body.deploymentName || `deployment-${new Date().getTime()}`;
+                    delete body.deploymentName;
+                    path = `/subscriptions/${subscriptionId}/resourcegroups/${resourceGroupName}/providers/Microsoft.Resources/deployments/${deploymentName}`;
+                    method = 'put';
+                    apiVersion = apiVersion || defaultApiVersions['deployments'];
+                    break;
+                case 'deleteResource':
+                    if (!resourceGroupName || !providerNamespace || !resourceType || !resourceName) {
+                        throw new Error("Operation 'deleteResource' requires resourceGroupName, providerNamespace, resourceType, and resourceName");
+                    }
+                    path = `/subscriptions/${subscriptionId}/resourceGroups/${resourceGroupName}/providers/${providerNamespace}/${resourceType}/${resourceName}`;
+                    method = 'delete';
+                    const deleteResourceKey = `${providerNamespace}/${resourceType}`;
+                    apiVersion = apiVersion || defaultApiVersions[deleteResourceKey] || '2021-04-01';
+                    break;
+            }
         }
-        else if (lowerQuestion.includes("roles") || lowerQuestion.includes("directory roles")) {
-            path = "/directoryRoles";
+        // Ensure API version is provided
+        if (!apiVersion && !queryParams['api-version']) {
+            throw new Error("Azure Resource Management API requires an 'apiVersion' parameter");
         }
-        // If a GUID was found and not already used in the path, append it
-        if (guidMatch && !path.includes(guidMatch[0])) {
-            path = `${path}/${guidMatch[0]}`;
+        // Get Azure credential
+        const credential = getAzureCredential();
+        // Construct the base URL and path
+        const baseUrl = "https://management.azure.com";
+        let fullPath = path;
+        if (subscriptionId && !path.includes('/subscriptions/')) {
+            fullPath = `/subscriptions/${subscriptionId}${path.startsWith('/') ? path : `/${path}`}`;
         }
-        // Build and execute the request
-        let request = graphClient.api(path);
-        // Execute the request
-        const result = await request.get();
-        // Format the response
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `📊 Entra API Result (${path}):\n\n${JSON.stringify(result, null, 2)}`,
-                },
-            ],
+        // Add api-version and other query parameters
+        const params = new URLSearchParams(queryParams);
+        if (apiVersion)
+            params.set('api-version', apiVersion);
+        // Get access token
+        const tokenResponse = await credential.getToken("https://management.azure.com/.default");
+        if (!tokenResponse?.token)
+            throw new Error("Failed to acquire Azure access token");
+        // Prepare request options
+        const headers = {
+            'Authorization': `Bearer ${tokenResponse.token}`,
+            'Content-Type': 'application/json'
+        };
+        const options = {
+            method: method.toUpperCase(),
+            headers
         };
+        if (['POST', 'PUT', 'PATCH'].includes(method.toUpperCase()) && body) {
+            options.body = JSON.stringify(body);
+        }
+        // Construct URL
+        const url = `${baseUrl}${fullPath}?${params.toString()}`;
+        // Execute request with pagination if needed
+        let result;
+        if (method === 'get' && fetchAllPages) {
+            // Fetch first page
+            const response = await fetch(url, options);
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Azure API error: ${response.status} - ${errorText}`);
+            }
+            const firstPage = await response.json();
+            // If no pagination needed, return first page
+            if (!firstPage.nextLink) {
+                result = firstPage;
+            }
+            else {
+                // Collect all items from all pages
+                const allItems = [...(firstPage.value || [])];
+                let nextLink = firstPage.nextLink;
+                while (nextLink) {
+                    const pageResponse = await fetch(nextLink, options);
+                    if (!pageResponse.ok)
+                        throw new Error(`Azure API pagination error: ${pageResponse.status}`);
+                    const nextPage = await pageResponse.json();
+                    if (nextPage.value)
+                        allItems.push(...nextPage.value);
+                    nextLink = nextPage.nextLink || null;
+                }
+                result = {
+                    value: allItems,
+                    count: allItems.length
+                };
+            }
+        }
+        else {
+            // Single page request
+            const response = await fetch(url, options);
+            if (!response.ok) {
+                const errorText = await response.text();
+                let errorDetail;
+                try {
+                    errorDetail = JSON.parse(errorText);
+                }
+                catch {
+                    errorDetail = errorText;
+                }
+                const error = new Error(`Azure API error: ${response.status}`);
+                error.status = response.status;
+                error.response = { body: errorDetail };
+                throw error;
+            }
+            const text = await response.text();
+            result = text ? JSON.parse(text) : { status: "Success" };
+        }
+        return formatApiResponse('Azure', method, path, result);
     }
     catch (err) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Error querying Entra API: ${err instanceof Error ? err.message : String(err)}`,
-                },
-            ],
-        };
+        return formatErrorResponse(err, 'Azure');
     }
 });
-// Helper function to initialize the Microsoft Graph client
-function initGraphClient() {
-    const tenantId = process.env.TENANT_ID;
-    const clientId = process.env.CLIENT_ID;
-    const clientSecret = process.env.CLIENT_SECRET;
-    if (!tenantId || !clientId || !clientSecret) {
-        throw new Error("Missing required Entra environment variables: TENANT_ID, CLIENT_ID, or CLIENT_SECRET");
-    }
-    const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
-    const authProvider = new TokenCredentialAuthenticationProvider(credential, {
-        scopes: ["https://graph.microsoft.com/.default"],
-    });
-    return Client.initWithMiddleware({
-        authProvider: authProvider,
-    });
-}
-// Start the server with stdio transport
+// SERVER STARTUP
 async function main() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    console.error("EntraAware MCP Server running on stdio");
+    try {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        console.error("EntraAware MCP Server running on stdio");
+    }
+    catch (error) {
+        console.error("Error starting server:", error);
+        process.exit(1);
+    }
 }
 main().catch((error) => {
     console.error("Fatal error in main():", error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north7/entraaware",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "type": "module",
   "main": "build/index.js",
   "bin": {
@@ -16,7 +16,7 @@
   "keywords": ["mcp-server", "entra", "azure-ad", "mcp", "microsoft-graph"],
   "author": "",
   "license": "ISC",
-  "description": "MCP server for Microsoft Entra (Azure AD) integration",
+  "description": "MCP server for querying Entra and Azure",
   "files": [
     "build"
   ],