powerplatform-mcp 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Michal Sobieraj
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# PowerPlatform MCP Server
+
+A Model Context Protocol (MCP) server for PowerPlatform/Dataverse entities. This tool provides access to entity metadata and attributes in the PowerPlatform environment.
+
+## Installation
+
+You can install and run this tool in two ways:
+
+### Option 1: Install globally
+
+```bash
+npm install -g powerplatform-mcp
+```
+
+Then run it:
+
+```bash
+powerplatform-mcp
+```
+
+### Option 2: Run directly with npx
+
+Run without installing:
+
+```bash
+npx powerplatform-mcp
+```
+
+## Configuration
+
+Before running, set the following environment variables:
+
+```bash
+# PowerPlatform/Dataverse connection details
+POWERPLATFORM_URL=https://yourenvironment.crm.dynamics.com
+POWERPLATFORM_CLIENT_ID=your-azure-app-client-id
+POWERPLATFORM_CLIENT_SECRET=your-azure-app-client-secret
+POWERPLATFORM_TENANT_ID=your-azure-tenant-id
+```
+
+## Usage
+
+This is an MCP server designed to work with MCP-compatible clients like GitHub Copilot. Once running, it will expose tools for retrieving PowerPlatform entity metadata.
+
+### Available Tools
+
+- `get-entity-metadata`: Get metadata about a PowerPlatform entity
+- `get-entity-attributes`: Get attributes/fields of a PowerPlatform entity
+
+## License
+
+MIT

package/build/PowerPlatformService.js

@@ -0,0 +1,85 @@
+import { ConfidentialClientApplication } from '@azure/msal-node';
+import axios from 'axios';
+export class PowerPlatformService {
+    config;
+    msalClient;
+    accessToken = null;
+    tokenExpirationTime = 0;
+    constructor(config) {
+        this.config = config;
+        // Initialize MSAL client
+        this.msalClient = new ConfidentialClientApplication({
+            auth: {
+                clientId: this.config.clientId,
+                clientSecret: this.config.clientSecret,
+                authority: `https://login.microsoftonline.com/${this.config.tenantId}`,
+            }
+        });
+    }
+    /**
+     * Get an access token for the PowerPlatform API
+     */
+    async getAccessToken() {
+        const currentTime = Date.now();
+        // If we have a token that isn't expired, return it
+        if (this.accessToken && this.tokenExpirationTime > currentTime) {
+            return this.accessToken;
+        }
+        try {
+            // Get a new token
+            const result = await this.msalClient.acquireTokenByClientCredential({
+                scopes: [`${this.config.organizationUrl}/.default`],
+            });
+            if (!result || !result.accessToken) {
+                throw new Error('Failed to acquire access token');
+            }
+            this.accessToken = result.accessToken;
+            // Set expiration time (subtract 5 minutes to refresh early)
+            if (result.expiresOn) {
+                this.tokenExpirationTime = result.expiresOn.getTime() - (5 * 60 * 1000);
+            }
+            return this.accessToken;
+        }
+        catch (error) {
+            console.error('Error acquiring access token:', error);
+            throw new Error('Authentication failed');
+        }
+    }
+    /**
+     * Make an authenticated request to the PowerPlatform API
+     */
+    async makeRequest(endpoint) {
+        try {
+            const token = await this.getAccessToken();
+            const response = await axios({
+                method: 'GET',
+                url: `${this.config.organizationUrl}/${endpoint}`,
+                headers: {
+                    'Authorization': `Bearer ${token}`,
+                    'Accept': 'application/json',
+                    'OData-MaxVersion': '4.0',
+                    'OData-Version': '4.0'
+                }
+            });
+            return response.data;
+        }
+        catch (error) {
+            console.error('PowerPlatform API request failed:', error);
+            throw new Error(`PowerPlatform API request failed: ${error}`);
+        }
+    }
+    /**
+     * Get metadata about an entity
+     * @param entityName The logical name of the entity
+     */
+    async getEntityMetadata(entityName) {
+        return this.makeRequest(`api/data/v9.2/EntityDefinitions(LogicalName='${entityName}')`);
+    }
+    /**
+     * Get metadata about entity attributes/fields
+     * @param entityName The logical name of the entity
+     */
+    async getEntityAttributes(entityName) {
+        return this.makeRequest(`api/data/v9.2/EntityDefinitions(LogicalName='${entityName}')/Attributes`);
+    }
+}

package/build/index.js

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { PowerPlatformService } from "./PowerPlatformService.js";
+// Environment configuration
+// These values can be set in environment variables or loaded from a configuration file
+const POWERPLATFORM_CONFIG = {
+    organizationUrl: process.env.POWERPLATFORM_URL || "",
+    clientId: process.env.POWERPLATFORM_CLIENT_ID || "",
+    clientSecret: process.env.POWERPLATFORM_CLIENT_SECRET || "",
+    tenantId: process.env.POWERPLATFORM_TENANT_ID || "",
+};
+// Create server instance
+const server = new McpServer({
+    name: "powerplatform-mcp",
+    version: "1.0.0",
+});
+let powerPlatformService = null;
+// Function to initialize PowerPlatformService on demand
+function getPowerPlatformService() {
+    if (!powerPlatformService) {
+        // Check if configuration is complete
+        const missingConfig = [];
+        if (!POWERPLATFORM_CONFIG.organizationUrl)
+            missingConfig.push("organizationUrl");
+        if (!POWERPLATFORM_CONFIG.clientId)
+            missingConfig.push("clientId");
+        if (!POWERPLATFORM_CONFIG.clientSecret)
+            missingConfig.push("clientSecret");
+        if (!POWERPLATFORM_CONFIG.tenantId)
+            missingConfig.push("tenantId");
+        if (missingConfig.length > 0) {
+            throw new Error(`Missing PowerPlatform configuration: ${missingConfig.join(", ")}. Set these in environment variables.`);
+        }
+        // Initialize service
+        powerPlatformService = new PowerPlatformService(POWERPLATFORM_CONFIG);
+        console.error("PowerPlatform service initialized");
+    }
+    return powerPlatformService;
+}
+// PowerPlatform entity metadata
+server.tool("get-entity-metadata", "Get metadata about a PowerPlatform entity", {
+    entityName: z.string().describe("The logical name of the entity"),
+}, async ({ entityName }) => {
+    try {
+        // Get or initialize PowerPlatformService
+        const service = getPowerPlatformService();
+        const metadata = await service.getEntityMetadata(entityName);
+        // Format the metadata as a string for text display
+        const metadataStr = JSON.stringify(metadata, null, 2);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Entity metadata for '${entityName}':\n\n${metadataStr}`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        console.error("Error getting entity metadata:", error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Failed to get entity metadata: ${error}`,
+                },
+            ],
+        };
+    }
+});
+// PowerPlatform entity attributes
+server.tool("get-entity-attributes", "Get attributes/fields of a PowerPlatform entity", {
+    entityName: z.string().describe("The logical name of the entity"),
+}, async ({ entityName }) => {
+    try {
+        // Get or initialize PowerPlatformService
+        const service = getPowerPlatformService();
+        const attributes = await service.getEntityAttributes(entityName);
+        // Format the attributes as a string for text display
+        const attributesStr = JSON.stringify(attributes, null, 2);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Attributes for entity '${entityName}':\n\n${attributesStr}`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        console.error("Error getting entity attributes:", error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Failed to get entity attributes: ${error}`,
+                },
+            ],
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Initializing PowerPlatform MCP Server...");
+}
+main().catch((error) => {
+    console.error("Fatal error in main():", error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "powerplatform-mcp",
+  "version": "0.2.0",
+  "description": "PowerPlatform Model Context Protocol server",
+  "main": "build/index.js",
+  "bin": {
+    "powerplatform-mcp": "./build/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "build",
+    "README.md"
+  ],
+  "keywords": [
+    "powerplatform",
+    "mcp",
+    "model-context-protocol",
+    "dynamics",
+    "dataverse"
+  ],
+  "author": "Michal Sobieraj",
+  "license": "MIT",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/michsob/powerplatform-mcp.git"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "@azure/msal-node": "^3.3.0",
+    "@modelcontextprotocol/sdk": "^1.7.0",
+    "axios": "^1.8.3",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "typescript": "^5.8.2"
+  }
+}