powerplatform-mcp 0.4.5 → 1.0.0

package/README.md

@@ -1,6 +1,6 @@
 # PowerPlatform MCP Server
 
-A Model Context Protocol (MCP) server that provides intelligent access to PowerPlatform/Dataverse entities and records. This tool offers comprehensive entity exploration, metadata access, and AI-assisted query capabilities through GitHub Copilot integration.
+A Model Context Protocol (MCP) server that provides intelligent access to PowerPlatform/Dataverse entities and records. This tool offers context-aware assistance, entity exploration and metadata access.
 
 Key features:
 - Rich entity metadata exploration with formatted, context-aware prompts
@@ -9,8 +9,6 @@ Key features:
 - AI-assisted query building and data modeling through AI agent
 - Full access to entity attributes, relationships, and global option sets
 
-Perfect for developers working with PowerPlatform/Dataverse who want intelligent, context-aware assistance for entity exploration and data querying.
-
 ## Installation
 
 You can install and run this tool in two ways:
@@ -47,9 +45,29 @@ POWERPLATFORM_CLIENT_SECRET=your-azure-app-client-secret
 POWERPLATFORM_TENANT_ID=your-azure-tenant-id
 ```
 
+### For Development
+
+1. Clone the repository and install dependencies:
+   ```bash
+   git clone https://github.com/michsob/powerplatform-mcp.git
+   cd powerplatform-mcp
+   npm install
+   ```
+
+2. Copy `.env.example` to `.env` and fill in your credentials:
+   ```bash
+   cp .env.example .env
+   ```
+
+3. Build and test:
+   ```bash
+   npm run build
+   npm run inspector:debug
+   ```
+
 ## 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.
+This is an MCP server designed to work with MCP-compatible clients like Cursor, Claude App and GitHub Copilot. Once running, it will expose tools for retrieving PowerPlatform entity metadata and records.
 
 ### Available Tools
 
@@ -64,7 +82,7 @@ This is an MCP server designed to work with MCP-compatible clients like GitHub C
 
 ## MCP Prompts
 
-The server includes a prompts feature that provides formatted, context-rich information about PowerPlatform entities. These prompts are ideal for use with AI assistants like GitHub Copilot.
+The server includes a prompts feature that provides formatted, context-rich information about PowerPlatform entities.
 
 ### Available Prompt Types
 
@@ -205,22 +223,18 @@ This shows all relationships for the 'contact' entity:
 - contactquotes_association: contact (N) ↔ quote (N)
 ```
 
-## Integration with AI Assistants
-
-These prompts are particularly valuable when used with AI assistants like GitHub Copilot that can integrate with MCP.
-
-### GitHub Copilot Examples
+## Prompt Examples
 
-Here are some examples of how you can interact with GitHub Copilot using the PowerPlatform MCP prompts:
+Here are some examples of how you can interact with assistant using the PowerPlatform MCP prompts:
 
-#### 1. Entity Understanding
+### 1. Entity Understanding
 
-You can ask GitHub Copilot about entities in natural language:
+You can ask assistant about entities in natural language:
 
 ```
 User: "Tell me about the Account entity in our PowerPlatform environment"
 
-GitHub Copilot: Let me fetch the entity overview for you...
+Response:
 [uses ENTITY_OVERVIEW prompt internally]
 
 Here's what I found about the Account entity:
@@ -234,14 +248,14 @@ Here's what I found about the Account entity:
 - It has 42 one-to-many relationships and 8 many-to-many relationships
 ```
 
-#### 2. Building Queries
+### 2. Building Queries
 
 You can ask for help constructing queries:
 
 ```
 User: "Help me write a query to find active accounts with revenue over $1M in California"
 
-GitHub Copilot: I'll help you build that query...
+Response:
 [uses QUERY_TEMPLATE prompt internally]
 
 Here's the OData query you need:
@@ -259,14 +273,14 @@ This query:
 5. Orders by revenue highest to lowest
 ```
 
-#### 3. Understanding Relationships
+### 3. Understanding Relationships
 
 You can explore entity relationships naturally:
 
 ```
 User: "How are Accounts and Contacts related in our system?"
 
-GitHub Copilot: Let me check the relationship maps...
+Response:
 [uses RELATIONSHIP_MAP prompt for both entities internally]
 
 Here are the key relationships between Accounts and Contacts:
@@ -284,14 +298,14 @@ Here are the key relationships between Accounts and Contacts:
    - account_connections: For relationship management
 ```
 
-#### 4. Field/Attribute Investigation
+### 4. Field/Attribute Investigation
 
 You can ask about specific fields:
 
 ```
 User: "What kind of field is the revenue field on Account?"
 
-GitHub Copilot: Let me check the attribute details...
+Response:
 [uses ATTRIBUTE_DETAILS prompt internally]
 
 The revenue field on Account is:
@@ -303,14 +317,14 @@ The revenue field on Account is:
 - Can be used in advanced find and filtered views
 ```
 
-#### 5. Complex Data Modeling
+### 5. Complex Data Modeling
 
 You can get help with data modeling decisions:
 
 ```
 User: "I need to design a solution for tracking product reviews. Which entities should I relate to?"
 
-GitHub Copilot: Let me analyze the relevant entities...
+Response:
 [uses multiple ENTITY_OVERVIEW and RELATIONSHIP_MAP prompts internally]
 
 Based on the existing data model, here's a suggested approach:
@@ -326,36 +340,11 @@ Based on the existing data model, here's a suggested approach:
    - Contact (N:1) - Reviews are written by contacts
    - Account (N:1) - Optional link to company if B2B review
 
-Here's a sample lookup field structure...
-[continues with detailed implementation guidance]
-```
-
-#### 6. Debugging Assistance
 
-You can get help troubleshooting:
-
-```
-User: "Why am I getting 'invalid property' when querying account.customertypecode?"
 
-GitHub Copilot: Let me check the attribute details...
-[uses ATTRIBUTE_DETAILS prompt internally]
-
-I see the issue. The field 'customertypecode' is actually named 'customertype' in your environment. Here's the correct field information:
-- Logical Name: customertype
-- Type: OptionSetValue
-- Valid Values:
-  * 1 = Competitor
-  * 2 = Consultant
-  * 3 = Customer
-  * 4 = Investor
-  * 5 = Partner
-  * 6 = Influencer
-
-Try updating your query to use 'customertype' instead of 'customertypecode'.
-```
 
-These examples show how GitHub Copilot can leverage the MCP prompts to provide context-aware, accurate assistance for PowerPlatform development tasks. The AI understands your environment's specific configuration and can help with both simple queries and complex architectural decisions.
+These examples show how AI assistant can leverage the MCP prompts to provide context-aware, accurate assistance for PowerPlatform development tasks. The AI understands your environment's specific configuration and can help with both simple queries and complex architectural decisions.
 
 ## License
 
-MIT
+MIT

package/build/PowerPlatformClient.js

@@ -0,0 +1,83 @@
+import { ConfidentialClientApplication } from '@azure/msal-node';
+import axios from 'axios';
+/**
+ * Base client for PowerPlatform API access.
+ * Handles authentication and generic HTTP requests.
+ * Service classes should depend on this client via constructor injection.
+ */
+export class PowerPlatformClient {
+    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 the organization URL
+     */
+    get organizationUrl() {
+        return this.config.organizationUrl;
+    }
+    /**
+     * 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 GET request to the PowerPlatform API
+     * @param endpoint The API endpoint (relative to organization URL)
+     */
+    async get(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}`);
+        }
+    }
+}

package/build/PowerPlatformService.js

@@ -45,28 +45,6 @@ export class PowerPlatformService {
             throw new Error('Authentication failed');
         }
     }
-    /**
-     * Handle JSON-RPC error response
-     * @param error JSON-RPC error object
-     * @returns Formatted error information
-     */
-    handleJsonRpcError(error) {
-        // Log the error for debugging
-        console.error('JSON-RPC error:', error);
-        // Handle specific error codes
-        switch (error.code) {
-            case -32601:
-                return `Method not found: ${error.message}. Please check that you're calling a supported API method.`;
-            case -32602:
-                return `Invalid params: ${error.message}. Please check your request parameters.`;
-            case -32603:
-                return `Internal error: ${error.message}. Please try again later.`;
-            case -32000:
-                return `Server error: ${error.message}. Please check server logs for more details.`;
-            default:
-                return `RPC error ${error.code}: ${error.message}`;
-        }
-    }
     /**
      * Make an authenticated request to the PowerPlatform API
      */
@@ -86,16 +64,8 @@ export class PowerPlatformService {
             return response.data;
         }
         catch (error) {
-            // Type guard for axios error with response data
-            if (error && error.code && typeof error.code === 'number' && error.message) {
-                const jsonRpcError = error.response.data.error;
-                const errorMessage = this.handleJsonRpcError(jsonRpcError);
-                throw new Error(errorMessage);
-            }
-            // For any other type of error, convert to string safely
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            console.error('PowerPlatform API request failed:', errorMessage);
-            throw new Error(`PowerPlatform API request failed: ${errorMessage}`);
+            console.error('PowerPlatform API request failed:', error);
+            throw new Error(`PowerPlatform API request failed: ${error}`);
         }
     }
     /**