powerplatform-mcp 0.4.5 → 1.0.0

package/build/tools/pluginTools.js

@@ -0,0 +1,188 @@
+import { z } from "zod";
+/**
+ * Register plugin tools with the MCP server.
+ */
+export function registerPluginTools(server, ctx) {
+    // Get Plugin Assemblies
+    server.registerTool("get-plugin-assemblies", {
+        title: "Get Plugin Assemblies",
+        description: "Get all plugin assemblies in the environment",
+        inputSchema: {
+            includeManaged: z.boolean().optional().describe("Include managed assemblies (default: false)"),
+            maxRecords: z.number().optional().describe("Maximum number of records to retrieve (default: 100)"),
+        },
+        outputSchema: z.object({
+            totalCount: z.number(),
+            assemblies: z.any(),
+        }),
+    }, async ({ includeManaged, maxRecords }) => {
+        try {
+            const service = ctx.getPluginService();
+            const result = await service.getPluginAssemblies(includeManaged ?? false, maxRecords ?? 100);
+            return {
+                structuredContent: result,
+                content: [
+                    {
+                        type: "text",
+                        text: `Found ${result.totalCount} plugin assemblies:\n\n${JSON.stringify(result.assemblies, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error getting plugin assemblies:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to get plugin assemblies: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+    // Get Plugin Assembly Complete
+    server.registerTool("get-plugin-assembly-complete", {
+        title: "Get Plugin Assembly Complete",
+        description: "Get a plugin assembly by name with all related plugin types, steps, and images",
+        inputSchema: {
+            assemblyName: z.string().describe("The name of the plugin assembly"),
+            includeDisabled: z.boolean().optional().describe("Include disabled steps (default: false)"),
+        },
+        outputSchema: z.object({
+            assembly: z.any(),
+            pluginTypes: z.any(),
+            steps: z.any(),
+            validation: z.any(),
+        }),
+    }, async ({ assemblyName, includeDisabled }) => {
+        try {
+            const service = ctx.getPluginService();
+            const result = await service.getPluginAssemblyComplete(assemblyName, includeDisabled ?? false);
+            return {
+                structuredContent: result,
+                content: [
+                    {
+                        type: "text",
+                        text: `Plugin assembly '${assemblyName}':\n\n` +
+                            `Plugin Types: ${result.pluginTypes.length}\n` +
+                            `Steps: ${result.steps.length}\n` +
+                            `Potential Issues: ${result.validation.potentialIssues.length > 0 ? result.validation.potentialIssues.join(', ') : 'None'}\n\n` +
+                            `${JSON.stringify(result, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error getting plugin assembly:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to get plugin assembly: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+    // Get Entity Plugin Pipeline
+    server.registerTool("get-entity-plugin-pipeline", {
+        title: "Get Entity Plugin Pipeline",
+        description: "Get all plugins that execute on a specific entity, organized by message and stage",
+        inputSchema: {
+            entityName: z.string().describe("The logical name of the entity"),
+            messageFilter: z.string().optional().describe("Filter by specific message (e.g., 'Create', 'Update', 'Delete')"),
+            includeDisabled: z.boolean().optional().describe("Include disabled steps (default: false)"),
+        },
+        outputSchema: z.object({
+            entity: z.string(),
+            messages: z.any(),
+            steps: z.any(),
+            executionOrder: z.any(),
+        }),
+    }, async ({ entityName, messageFilter, includeDisabled }) => {
+        try {
+            const service = ctx.getPluginService();
+            const result = await service.getEntityPluginPipeline(entityName, messageFilter, includeDisabled ?? false);
+            return {
+                structuredContent: result,
+                content: [
+                    {
+                        type: "text",
+                        text: `Plugin pipeline for entity '${entityName}':\n\n` +
+                            `Total Steps: ${result.steps.length}\n` +
+                            `Messages: ${result.messages.length}\n\n` +
+                            `Execution Order:\n${result.executionOrder.map((name, i) => `${i + 1}. ${name}`).join('\n')}\n\n` +
+                            `${JSON.stringify(result, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error getting entity plugin pipeline:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to get entity plugin pipeline: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+    // Get Plugin Trace Logs
+    server.registerTool("get-plugin-trace-logs", {
+        title: "Get Plugin Trace Logs",
+        description: "Get plugin trace logs with filtering options",
+        inputSchema: {
+            entityName: z.string().optional().describe("Filter by entity name"),
+            messageName: z.string().optional().describe("Filter by message name (e.g., 'Create', 'Update')"),
+            correlationId: z.string().optional().describe("Filter by correlation ID"),
+            pluginStepId: z.string().optional().describe("Filter by plugin step ID"),
+            exceptionOnly: z.boolean().optional().describe("Only show logs with exceptions (default: false)"),
+            hoursBack: z.number().optional().describe("Hours to look back (default: 24)"),
+            maxRecords: z.number().optional().describe("Maximum number of records (default: 50)"),
+        },
+        outputSchema: z.object({
+            totalCount: z.number(),
+            logs: z.any(),
+        }),
+    }, async ({ entityName, messageName, correlationId, pluginStepId, exceptionOnly, hoursBack, maxRecords }) => {
+        try {
+            const service = ctx.getPluginService();
+            const result = await service.getPluginTraceLogs({
+                entityName,
+                messageName,
+                correlationId,
+                pluginStepId,
+                exceptionOnly: exceptionOnly ?? false,
+                hoursBack: hoursBack ?? 24,
+                maxRecords: maxRecords ?? 50,
+            });
+            const exceptionCount = result.logs.filter((log) => log.parsed?.hasException).length;
+            return {
+                structuredContent: result,
+                content: [
+                    {
+                        type: "text",
+                        text: `Plugin trace logs:\n\n` +
+                            `Total Logs: ${result.totalCount}\n` +
+                            `Exceptions: ${exceptionCount}\n\n` +
+                            `${JSON.stringify(result.logs, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error getting plugin trace logs:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to get plugin trace logs: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+}

package/build/tools/recordTools.js

@@ -0,0 +1,87 @@
+import { z } from "zod";
+/**
+ * Register record tools with the MCP server.
+ */
+export function registerRecordTools(server, ctx) {
+    // Get Record
+    server.registerTool("get-record", {
+        title: "Get Record",
+        description: "Get a specific record by entity name (plural) and ID",
+        inputSchema: {
+            entityNamePlural: z.string().describe("The plural name of the entity (e.g., 'accounts', 'contacts')"),
+            recordId: z.string().describe("The GUID of the record"),
+        },
+        outputSchema: z.object({
+            entityNamePlural: z.string(),
+            recordId: z.string(),
+            record: z.any(),
+        }),
+    }, async ({ entityNamePlural, recordId }) => {
+        try {
+            const service = ctx.getRecordService();
+            const record = await service.getRecord(entityNamePlural, recordId);
+            return {
+                structuredContent: { entityNamePlural, recordId, record },
+                content: [
+                    {
+                        type: "text",
+                        text: `Record from '${entityNamePlural}' with ID '${recordId}':\n\n${JSON.stringify(record, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error getting record:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to get record: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+    // Query Records
+    server.registerTool("query-records", {
+        title: "Query Records",
+        description: "Query records using an OData filter expression",
+        inputSchema: {
+            entityNamePlural: z.string().describe("The plural name of the entity (e.g., 'accounts', 'contacts')"),
+            filter: z.string().describe("OData filter expression (e.g., \"name eq 'test'\" or \"createdon gt 2023-01-01\")"),
+            maxRecords: z.number().optional().describe("Maximum number of records to retrieve (default: 50)"),
+        },
+        outputSchema: z.object({
+            entityNamePlural: z.string(),
+            filter: z.string(),
+            count: z.number(),
+            records: z.any(),
+        }),
+    }, async ({ entityNamePlural, filter, maxRecords }) => {
+        try {
+            const service = ctx.getRecordService();
+            const records = await service.queryRecords(entityNamePlural, filter, maxRecords || 50);
+            const recordCount = records.value?.length || 0;
+            return {
+                structuredContent: { entityNamePlural, filter, count: recordCount, records },
+                content: [
+                    {
+                        type: "text",
+                        text: `Retrieved ${recordCount} records from '${entityNamePlural}' with filter '${filter}':\n\n${JSON.stringify(records, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error querying records:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to query records: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+}

package/build/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "powerplatform-mcp",
-  "version": "0.4.5",
+  "version": "1.0.0",
   "description": "PowerPlatform Model Context Protocol server",
   "main": "build/index.js",
   "bin": {
@@ -8,7 +8,10 @@
   },
   "scripts": {
     "build": "tsc",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "start": "node build/index.js",
+    "dev": "npm run build && npm run start",
+    "inspector": "npm run build && dotenv -- npx @modelcontextprotocol/inspector node build/index.js"
   },
   "files": [
     "build",
@@ -32,16 +35,18 @@
     "url": "git+https://github.com/michsob/powerplatform-mcp.git"
   },
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=22.0.0 <25.0.0"
   },
   "dependencies": {
-    "@azure/msal-node": "^3.3.0",
-    "@modelcontextprotocol/sdk": "^1.7.0",
-    "axios": "^1.8.3",
-    "zod": "^3.24.2"
+    "@azure/msal-node": "^5.0.2",
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "axios": "^1.13.2",
+    "zod": "^4.3.5"
   },
   "devDependencies": {
     "@types/node": "^22.13.10",
+    "dotenv": "^17.2.3",
+    "dotenv-cli": "^11.0.0",
     "typescript": "^5.8.2"
   }
 }