@microsoft/powerbi-modeling-mcp 0.5.0-beta.2

package/CHANGELOG.md

@@ -0,0 +1,131 @@
+# CHANGELOG 📝
+
+The Power BI Modeling MCP Server is a multiplatform application that updates automatically in internal flows. Updates will be released periodically.
+
+## [0.5.0-beta.2] - 2026-03-27 - Pre-release
+
+### Features
+
+- *(npm)* Add NPM package release
+
+### Fixes
+
+- Minor fixes and stability improvements
+
+### Other Changes
+
+- Add agentic infrastructure documentation
+- *(security)* Update .NET SDK version to 8.0.504 for bug #2030536
+- *(security)* Update .NET SDK version to 8.0.419 for bug #2030536
+
+## [0.5.0-beta.1] - 2026-03-13 - Pre-release
+
+### Features
+
+- Support for the `authmode` parameter for service principal authentication.
+
+### Fixes
+
+- `IndexOutOfRangeException` when connecting to Analysis Services.
+- Execution metrics are now preserved on successful DAX execution.
+- Improved error message when setting `sortByColumn` on a column where `isAvailableInMdx = false`.
+- Improved Analysis Services connection stability and reconnection handling.
+
+## [0.4.0] - 2026-03-04
+
+### Features
+
+- Token consumption optimization
+
+## [0.3.2] - 2026-03-02 - Pre-release
+
+### Features
+
+- Linux platform support
+- Token consumption optimization
+
+### Fixes
+
+- Minor fixes and stability improvements
+
+## [0.2.3] - 2026-01-09 - Pre-release
+
+### Fixes
+
+- Minor fixes and stability improvements.
+- Deadlock issue resolved in table_operations GET
+
+## [0.2.2] - 2025-12-16 - Pre-release
+
+### Features
+
+- Support batch operations natively in all tools and removal of batch_* tools
+- Load MCP server on startup
+
+### Fixes
+
+- Minor fixes and stability improvements.
+
+## [0.1.9] - 2025-11-21
+
+### Features
+
+- Support for ARM based processors
+
+### Fixes
+
+- Bug fixes: connection name issue, null-ref dropping tables and others
+
+## [0.1.8] - 2025-11-18
+
+### Other Changes
+
+- Documentation updates
+
+## [0.1.7] - 2025-11-18
+
+### Features
+
+- Automatic connection names
+- Execution metrics option when running DAX queries
+
+### Fixes
+
+- Minor fixes and stability improvements.
+
+### Other Changes
+
+- Tool description updates
+
+## [0.1.5]
+
+### Features
+
+- DAX query execution metrics
+- User confirmation before running DAX queries
+
+### Fixes
+
+- Minor fixes and stability improvements.
+
+### Other Changes
+
+- Optimization to trace operations
+
+## [0.1.1]
+
+### Features
+
+- MCP prompts to facilitate connections: /ConnectToPowerBIDesktop; /ConnectToFabric; /ConnectToPowerBIProject
+- Support for Direct Lake entity partitions
+- Trace operations
+
+### Fixes
+
+- Minor fixes and stability improvements.
+
+## [0.1.0]
+
+### Features
+
+- Initial release

package/LICENSE

@@ -0,0 +1,99 @@
+# MICROSOFT SOFTWARE LICENSE TERMS 
+
+**Power BI Modeling MCP Server (PREVIEW)**
+
+These license terms are an agreement between you and Microsoft Corporation (or one of its affiliates). They apply to the software named above and any Microsoft services or software updates (except to the extent such services or updates are accompanied by new or additional terms, in which case those different terms apply prospectively and do not alter your or Microsoftís rights relating to pre-updated software or services). IF YOU COMPLY WITH THESE LICENSE TERMS, YOU HAVE THE RIGHTS BELOW. BY USING THE SOFTWARE, YOU ACCEPT THESE TERMS.
+
+**INSTALLATION AND USE RIGHTS.**
+
+**a) General.** You may install and use any number of copies of the software on your devices, solely to demonstrate, and for your internal business purposes to develop and test your applications. You may not use the software in a live operating environment unless Microsoft permits you to do so under another agreement.
+
+**b) Work or School Accounts.** You can sign into the software with a work or school email address. If you do, you agree that the owner of the domain associated with your email address may control and administer your account, and access and process your data, including the contents of your communications and files. You further agree that your use of the software may be subject to: i) your organizationís guidelines and policies regarding the use of the software; and ii) the agreements Microsoft has with you or your organization, and in such case these terms may not apply. If you already have a Microsoft account and you use a separate work or school email address to access the software, you may be prompted to update the email address associated with your Microsoft account to continue accessing the software.
+
+**c) Included Microsoft Applications.** The software may include other Microsoft applications. These license terms apply to those included applications, if any, unless other license terms are provided with the other Microsoft applications.
+
+**d) Competitive Benchmarking.** If you are a direct competitor, and you access or use the software for purposes of competitive benchmarking, analysis, or intelligence gathering, you waive as against Microsoft, its subsidiaries, and its affiliated companies (including prospectively) any competitive use, access, and benchmarking test restrictions in the terms governing your software to the extent your terms of use are, or purport to be, more restrictive than Microsoftís terms. If you do not waive any such purported restrictions in the terms governing your software, you are not allowed to access or use this software, and will not do so.
+
+**TIME-SENSITIVE SOFTWARE.**
+
+**a) Period.** This agreement is effective on your acceptance and terminates on the earlier of (i) 30 days following first availability of a commercial release of the software or (ii) upon termination by Microsoft. Microsoft may extend this agreement in its discretion.
+
+**b) Notice.** You may receive periodic reminder notices of this date through the software.
+
+**c) Access to data.** You may not be able to access data used in the software when it stops running.
+
+**SCOPE OF LICENSE.** The software is licensed, not sold. Microsoft reserves all other rights. Unless applicable law gives you more rights despite this limitation, you will not (and have no right to):
+
+a) work around any technical limitations in the software that only allow you to use it in certain ways;
+
+b) reverse engineer, decompile or disassemble the software, or otherwise attempt to derive the source code for the software, except and to the extent required by third party licensing terms governing use of certain open source components that may be included in the software;
+
+c) remove, minimize, block, or modify any notices of Microsoft or its suppliers in the software;
+
+d) use the software in any way that is against the law or to create or propagate malware; or
+
+e) share, publish, distribute, or lease the software, provide the software as a stand-alone offering for others to use, or transfer the software or this agreement to any third party.
+
+**PRE-RELEASE SOFTWARE.** The software is a pre-release version. It may not operate correctly. It may be different from the commercially released version.
+
+**FEEDBACK.** If you give feedback about the software to Microsoft, you give to Microsoft, without charge, the right to use, share and commercialize your feedback in any way and for any purpose. You will not give feedback that is subject to a license that requires Microsoft to license its software or documentation to third parties because Microsoft includes your feedback in them. These rights survive this agreement.
+
+**DATA.**
+
+**a) Data Collection.** The software may collect information about you and your use of the software, and send that to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may opt-out of many of these scenarios, but not all, as described in the product documentation.† There are also some features in the software that may enable you to collect data from users of your applications. If you use these features to enable data collection in your applications, you must comply with applicable law, including providing appropriate notices to users of your applications. You can learn more about data collection and use in the help documentation and the privacy statement at https://go.microsoft.com/fwlink/?linkid=521839. Your use of the software operates as your consent to these practices.
+
+**b) Processing of Personal Data.** To the extent Microsoft is a processor or subprocessor of personal data in connection with the software, Microsoft makes the commitments in the European Union General Data Protection Regulation Terms of the Microsoft Products and Services Data Protection Addendum to all customers effective May 25, 2018, at https://go.microsoft.com/fwlink/?linkid=2135030.
+
+**EXPORT RESTRICTIONS.** You must comply with all domestic and international export laws and regulations that apply to the software, which include restrictions on destinations, end users, and end use. For further information on export restrictions, visit https://aka.ms/exporting.
+
+**SUPPORT SERVICES.** Microsoft is not obligated under this agreement to provide any support services for the software. Any support provided is ìas isî, ìwith all faultsî, and without warranty of any kind.
+
+**UPDATES.** The software may periodically check for updates, and download and install them for you. You may obtain updates only from Microsoft or authorized sources. Microsoft may need to update your system to provide you with updates. You agree to receive these automatic updates without any additional notice. Updates may not include or support all existing software features, services, or peripheral devices.
+
+**TERMINATION.** Without prejudice to any other rights, Microsoft may terminate this agreement if you fail to comply with any of its terms or conditions. In such event, you must destroy all copies of the software and all of its component parts.
+
+**ENTIRE AGREEMENT.** This agreement, and any other terms Microsoft may provide for supplements, updates, or third-party applications, is the entire agreement for the software.
+
+**APPLICABLE LAW AND PLACE TO RESOLVE DISPUTES.** If you acquired the software in the United States or Canada, the laws of the state or province where you live (or, if a business, where your principal place of business is located) govern the interpretation of this agreement, claims for its breach, and all other claims (including consumer protection, unfair competition, and tort claims), regardless of conflict of laws principles. If you acquired the software in any other country, its laws apply. If U.S. federal jurisdiction exists, you and Microsoft consent to exclusive jurisdiction and venue in the federal court in King County, Washington for all disputes heard in court. If not, you and Microsoft consent to exclusive jurisdiction and venue in the Superior Court of King County, Washington for all disputes heard in court.
+
+**CONSUMER RIGHTS; REGIONAL VARIATIONS.** This agreement describes certain legal rights. You may have other rights, including consumer rights, under the laws of your state, province, or country. Separate and apart from your relationship with Microsoft, you may also have rights with respect to the party from which you acquired the software. This agreement does not change those other rights if the laws of your state, province, or country do not permit it to do so. For example, if you acquired the software in one of the below regions, or mandatory country law applies, then the following provisions apply to you:
+
+**a) Australia.** You have statutory guarantees under the Australian Consumer Law and nothing in this agreement is intended to affect those rights.
+
+**b) Canada.** If you acquired this software in Canada, you may stop receiving updates by turning off the automatic update feature, disconnecting your device from the Internet (if and when you re-connect to the Internet, however, the software will resume checking for and installing updates), or uninstalling the software. The product documentation, if any, may also specify how to turn off updates for your specific device or software.
+
+**c) Germany and Austria.** i. Warranty. The properly licensed software will perform substantially as described in any Microsoft materials that accompany the software. However, Microsoft gives no contractual guarantee in relation to the licensed software. ii. Limitation of Liability. In case of intentional conduct, gross negligence, claims based on the Product Liability Act, as well as, in case of death or personal or physical injury, Microsoft is liable according to the statutory law.
+
+Subject to the foregoing clause ii., Microsoft will only be liable for slight negligence if Microsoft is in breach of such material contractual obligations, the fulfillment of which facilitate the due performance of this agreement, the breach of which would endanger the purpose of this agreement and the compliance with which a party may constantly trust in (so-called "cardinal obligations"). In other cases of slight negligence, Microsoft will not be liable for slight negligence.
+
+**DISCLAIMER OF WARRANTY. THE SOFTWARE IS LICENSED ìAS IS.î YOU BEAR THE RISK OF USING IT. MICROSOFT GIVES NO EXPRESS WARRANTIES, GUARANTEES, OR CONDITIONS. TO THE EXTENT PERMITTED UNDER APPLICABLE LAWS, MICROSOFT EXCLUDES ALL IMPLIED WARRANTIES, INCLUDING MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.**
+
+**LIMITATION ON AND EXCLUSION OF DAMAGES. IF YOU HAVE ANY BASIS FOR RECOVERING DAMAGES DESPITE THE PRECEDING DISCLAIMER OF WARRANTY, YOU CAN RECOVER FROM MICROSOFT AND ITS SUPPLIERS ONLY DIRECT DAMAGES UP TO U.S. $5.00. YOU CANNOT RECOVER ANY OTHER DAMAGES, INCLUDING CONSEQUENTIAL, LOST PROFITS, SPECIAL, INDIRECT OR INCIDENTAL DAMAGES.**
+
+**This limitation applies to (a) anything related to the software, services, content (including code) on third party Internet sites, or third party applications; and (b) claims for breach of contract, warranty, guarantee, or condition; strict liability, negligence, or other tort; or any other claim; in each case to the extent permitted by applicable law.**
+
+**It also applies even if Microsoft knew or should have known about the possibility of the damages. The above limitation or exclusion may not apply to you because your state, province, or country may not allow the exclusion or limitation of incidental, consequential, or other damages.**
+
+**CONFIDENTIAL INFORMATION.** The software, including its user interface, features and documentation, is confidential and proprietary to Microsoft and its suppliers.
+
+**a) Use.** For five years after installation of the software or its commercial release, whichever is first, you may not disclose confidential information to third parties. You may disclose confidential information only to your employees and consultants who need to know the information. You must have written agreements with them that protect the confidential information at least as much as this agreement.
+
+**b) Survival.** Your duty to protect confidential information survives this agreement.
+
+**c) Exclusions.** You may disclose confidential information in response to a judicial or governmental order. You must first give written notice to Microsoft to allow it to seek a protective order or otherwise protect the information. Confidential information does not include information that: i. becomes publicly known through no wrongful act; ii. you received from a third party who did not breach confidentiality obligations to Microsoft or its suppliers; or iii. you developed independently.
+
+**Please note: As this software is distributed in Canada, some of the clauses in this agreement are provided below in French.**
+
+**Remarque: Ce logiciel Ètant distribuÈ au Canada, certaines des clauses dans ce contrat sont fournies ci-dessous en français.**
+
+**EXONERATION DE GARANTIE. Le logiciel visÈ par une licence est offert ´ tel quel ª. Toute utilisation de ce logiciel est ‡ votre seule risque et pÈril. Microsoft níaccorde aucune autre garantie expresse. Vous pouvez bÈnÈficier de droits additionnels en vertu du droit local sur la protection des consommateurs, que ce contrat ne peut modifier. La ou elles sont permises par le droit locale, les garanties implicites de qualitÈ marchande, díadÈquation ‡ un usage particulier et díabsence de contrefaÁon sont exclues.**
+
+**LIMITATION DES DOMMAGES-INT…R TS ET EXCLUSION DE RESPONSABILIT… POUR LES DOMMAGES. Vous pouvez obtenir de Microsoft et de ses fournisseurs une indemnisation en cas de dommages directs uniquement ‡ hauteur de 5,00 $ US. Vous ne pouvez prÈtendre ‡ aucune indemnisation pour les autres dommages, y compris les dommages spÈciaux, indirects ou accessoires et pertes de bÈnÈfices.**
+
+**Cette limitation concerne:**
+
+**tout ce qui est reliÈ au logiciel, aux services ou au contenu (y compris le code) figurant sur des sites Internet tiers ou dans des programmes tiers; et
+les rÈclamations au titre de violation de contrat ou de garantie, ou au titre de responsabilitÈ stricte, de nÈgligence ou díune autre faute dans la limite autorisÈe par la loi en vigueur.**
+**Elle síapplique Ègalement, mÍme si Microsoft connaissait ou devrait connaÓtre líÈventualitÈ díun tel dommage. Si votre pays níautorise pas líexclusion ou la limitation de responsabilitÈ pour les dommages indirects, accessoires ou de quelque nature que ce soit, il se peut que la limitation ou líexclusion ci-dessus ne síappliquera pas ‡ votre Ègard.**
+
+**EFFET JURIDIQUE. Le prÈsent contrat dÈcrit certains droits juridiques. Vous pourriez avoir díautres droits prÈvus par les lois de votre pays. Le prÈsent contrat ne modifie pas les droits que vous confËrent les lois de votre pays si celles-ci ne le permettent pas.**

package/README.md

@@ -0,0 +1,120 @@
+# ✨ Power BI Modeling MCP Server NPM Package
+
+The **Power BI Modeling MCP Server** brings Power BI semantic modeling capabilities to your AI agents through a **local MCP server**. This allows developers and AI applications to interact with Power BI models in entirely new ways, from using natural language to execute modeling changes to autonomous AI agentic development workflows.
+
+## 💡 What can you do?
+
+- **🔄 Build and Modify Semantic Models with Natural Language** - Tell your AI assistant what you need, and it uses this MCP server to create, update, and manage tables, columns, measures, relationships, and more... across Power BI Desktop and Fabric semantic models.
+
+- **⚡ Bulk Operations at Scale** - AI applications can execute batch modeling operations on hundreds of objects simultaneously — bulk renaming, bulk refactoring, model translations, or model security rules - with transaction support and error handling, turning hours of repetitive work into seconds.
+
+- **✅ Apply modeling best practices** - Easily evaluate and implement modeling best practices against your model.
+
+- **🤖 Agentic Development Workflows** - Supports working with [TMDL and Power BI Project files](https://learn.microsoft.com/power-bi/developer/projects/projects-dataset#tmdl-format), enabling AI agents to autonomously plan, create, and execute complex modeling tasks across your semantic model codebase.
+
+- **🔍 Query and Validate DAX** - AI assistants can execute and validate DAX queries against your model, helping you test measures, troubleshoot calculations, and explore your data
+
+📹 Watch the video for an [end-to-end demo](https://aka.ms/power-modeling-mcp-demo).
+
+More details on how to use and configure this MCP are available in the GitHub repository: [powerbi-modeling-mcp](https://aka.ms/powerbi-modeling-mcp).
+
+## 📋 Prerequisites
+
+Before getting started, ensure you have **Node.js** (which includes NPM and NPX) installed:
+
+- **Node.js 18+** - [Download from nodejs.org](https://nodejs.org/)
+
+You can verify your installation by running:
+
+```bash
+node --version
+npm --version
+```
+
+## 📦 Installation
+
+Configure the `mcp.json` file with the following:
+
+```json
+{
+    "mcpServers": {
+        "powerbi-modeling-mcp": {
+			"type": "local",
+			"command": "npx",
+			"args": [
+				"-y",
+				"@microsoft/powerbi-modeling-mcp",
+				"--start",            
+				]
+        }
+    }
+}
+```
+
+**Note:** When manually configuring Visual Studio and Visual Studio Code, use `servers` instead of `mcpServers` as the root object.
+
+## 🚀 Get started
+
+**First, you must connect to a Power BI semantic model**, which can reside in Power BI Desktop, Fabric workspace or in Power BI Project (PBIP) files.
+
+- **For Power BI Desktop:** 
+
+	```
+	Connect to '[File Name]' in Power BI Desktop
+	```
+
+- **For Semantic Model in Fabric Workspace:**
+
+	```
+	Connect to semantic model '[Semantic Model Name]' in Fabric Workspace '[Workspace Name]'
+	```
+  
+- **For Power BI Project files:**
+
+	```
+	Open semantic model from PBIP folder '[Path to the definition/ TMDL folder in the PBIP]'
+	```
+
+Once the connection is established, you can use natural language to ask the AI agent to make any modeling changes. To get started, try one of the following scenarios.
+
+## 💬 Feedback and Support
+
+- Check the [Troubleshooting guide](https://github.com/microsoft/powerbi-modeling-mcp/blob/main/TROUBLESHOOTING.md) to diagnose and resolve common issues.
+- We're building this in the open. Your feedback is much appreciated, and will help us shape the future of the Power BI Modeling MCP server.
+    - 👉 [Open an issue](https://github.com/microsoft/powerbi-modeling-mcp/issues) in the public GitHub repository - we’d love to hear from you!
+
+## Security
+
+Your credentials are always handled securely through the official [Azure Identity SDK](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/identity/Azure.Identity/README.md) - **we never store or manage tokens directly**.
+
+MCP as a phenomenon is very novel and cutting-edge. As with all new technology standards, consider doing a security review to ensure any systems that integrate with MCP servers follow all regulations and standards your system is expected to adhere to. This includes not only the Power BI Modeling MCP Server, but any MCP client/agent that you choose to implement down to the model provider.
+
+You should follow Microsoft security guidance for MCP servers, including enabling Entra ID authentication, secure token management, and network isolation. Refer to [Microsoft Security Documentation](https://learn.microsoft.com/en-us/azure/api-management/secure-mcp-servers) for details.
+
+## Permissions and Risk
+
+MCP clients can invoke operations based on the user’s Fabric RBAC permissions. Autonomous or misconfigured clients may perform destructive actions. You should review and apply least-privilege RBAC roles and implement safeguards before deployment. Certain safeguards, such as flags to prevent destructive operations, are not standardized in the MCP specification and may not be supported by all clients.
+
+## Data Collection
+
+The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft's [privacy statement](https://www.microsoft.com/privacy/privacystatement). You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.
+
+## Compliance Responsibility
+
+This MCP server may be installed, used and share data with third party clients and services, such as third party LLMs that operate outside Microsoft compliance boundaries. You are responsible for ensuring that any integration complies with applicable organizational, regulatory, and contractual requirements.
+
+## Third Party Components
+
+This MCP server may use or depend on third party components. You are responsible for reviewing and complying with the licenses and security posture of any third-party components.
+
+## Export Control
+
+Use of this software must comply with all applicable export laws and regulations, including U.S. Export Administration Regulations and local jurisdiction requirements.
+
+## No Warranty / Limitation of Liability
+
+This software is provided “as is” without warranties or conditions of any kind, either express or implied. Microsoft shall not be liable for any damages arising from use, misuse, or misconfiguration of this software.
+
+## Code of Conduct
+
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information, see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [open@microsoft.com](mailto:open@microsoft.com) with any additional questions or comments.

package/index.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+// -----------------------------------------------------------------------
+// <copyright company="Microsoft Corporation">
+//    copyright (c) Microsoft Corporation.  All rights reserved.
+// </copyright>
+// -----------------------------------------------------------------------
+
+const os = require('os')
+const packageJson = require('./package.json')
+const { get } = require('http')
+
+// Check if DEBUG environment variable is set
+const isDebugMode = process.env.DEBUG && (
+  process.env.DEBUG.toLowerCase() === 'true' ||
+  process.env.DEBUG.includes('mcp') ||
+  process.env.DEBUG === '*'
+)
+
+// Helper function for debug logging
+function debugLog(...args) {
+  if (isDebugMode) {
+    console.error(...args)
+  }
+}
+
+// Helper function to get command line argument value
+const getArgument = (argName) => {
+    let argIndex = process.argv.indexOf(argName);
+    if (argIndex !== -1 && argIndex < process.argv.length - 1) {
+        return process.argv[argIndex + 1] || null;
+    }
+    return null;
+}
+
+const packageName = packageJson.name
+
+// Check for --help argument
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    console.log(`
+Usage: ${packageName} [options]
+
+Options:
+    --help, -h         Show this help message
+    --use-version      Specify a specific version to use
+
+Environment Variables:
+    DEBUG              Enable debug logging (true, mcp, or *)
+
+Examples:
+    ${packageName} --help
+    ${packageName} --use-version 1.0.0
+    DEBUG=true ${packageName}
+`)
+    process.exit(0)
+}
+
+debugLog('PowerBI Modeling MCP core package starting')
+debugLog('All args:')
+process.argv.forEach((val, index) => {
+  debugLog(`${index}: ${val}`)
+})
+
+const platform = os.platform()
+const arch = os.arch()
+
+const version = getArgument('--use-version') || packageJson.version || 'latest'
+const platformPackageName = `${packageName}-${platform}-${arch}`
+
+console.log(`Detected platform: ${platform}, architecture: ${arch}`)
+console.log(`Using ${platformPackageName} version: ${version}`)
+
+// Try to load the platform package
+let platformPackage
+try {
+  debugLog(`Attempting to require platform package: ${platformPackageName}`)
+  platformPackage = require(platformPackageName)
+} catch (err) {
+  debugLog(`Failed to require ${platformPackageName}, attempting auto-install: ${err.message}`)
+
+  // Try to automatically install the missing platform package
+  try {
+    const { execSync } = require('child_process')
+
+    console.error(`Installing missing platform package: ${platformPackageName}`)
+
+    // Try to install the platform package
+    try {
+      execSync(`npm install ${platformPackageName}@${version}`, {
+        stdio: ['inherit', 'inherit', 'pipe'], // Only pipe stderr to capture errors
+        timeout: 60000 // 60 second timeout
+      })
+    } catch (npmErr) {
+      // If npm install fails, try with --no-save and different install strategies
+      debugLog(`npm install failed, trying alternative installation methods: ${npmErr.message}`)
+
+      // Try with --no-save and --prefer-online
+      execSync(`npm install ${platformPackageName}@${version} --no-save --prefer-online`, {
+        stdio: ['inherit', 'inherit', 'pipe'],
+        timeout: 60000
+      })
+    }
+
+    // Clear module cache and try to require again after installation
+    Object.keys(require.cache).forEach(key => {
+      if (key.includes(platformPackageName)) {
+        delete require.cache[key]
+      }
+    })
+
+    platformPackage = require(platformPackageName)
+
+    console.error(`✅ Successfully installed and loaded ${platformPackageName}`)
+
+  } catch (installErr) {
+    debugLog(`Auto-install failed: ${installErr.message}`)
+
+    console.error(`\n❌ Failed to load platform specific package '${platformPackageName}'`)
+    console.error(`\n🔍 Troubleshooting steps:`)
+    console.error(`\n1. Clear npm cache:`)
+    console.error(`   npm cache clean --force`)
+    console.error(`\n2. If installing as a global tool, uninstall and reinstall:`)
+    console.error(`   npm uninstall -g ${packageName}`)
+    console.error(`   npm install -g ${packageName}`)
+    console.error(`\n3. If using npx, clear the npx cache and try again:`)
+    console.error(`   npx -y clear-npx-cache`)
+    console.error(`   npx -y ${packageName}@latest --version`)
+    console.error(`\n4. Manually install the platform package to check compatibility:`)
+    console.error(`   npm install ${platformPackageName}@latest`)
+    console.error(`\n5. Check your internet connection and try again`)
+    console.error(`\n6. If the issue persists, please report it at:`)
+    console.error(`   https://github.com/microsoft/mcp/issues`)
+    console.error(`\nOriginal error: ${err.message}`)
+    console.error(`Install error: ${installErr.message}`)
+    process.exit(1)
+  }
+}
+
+platformPackage.runExecutable(process.argv.slice(2))
+  .then((code) => {
+    debugLog(`Process exited with code: ${code}`)
+    process.exit(code)
+  })
+  .catch((err) => {
+    console.error(`Error: ${err.message}`)
+    process.exit(1)
+  })

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@microsoft/powerbi-modeling-mcp",
+  "version": "0.5.0-beta.2",
+  "description": "Power BI Modeling MCP Server - Node.js client package for installing and running the Power BI Modeling MCP server",
+  "author": "Microsoft",
+  "homepage": "https://github.com/microsoft/powerbi-modeling-mcp#readme",
+  "license": "Microsoft",
+  "keywords": [
+    "powerbi",
+    "modeling",
+    "mcp",
+    "model-context-protocol",
+    "semantic-model",
+    "tabular",
+    "analysis-services"
+  ],
+  "bugs": {
+    "url": "https://github.com/microsoft/powerbi-modeling-mcp/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/microsoft/powerbi-modeling-mcp.git",
+    "directory": "clients/node"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "bin": {
+    "powerbi-modeling-mcp": "./index.js"
+  },
+  "os": [
+    "win32",
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "optionalDependencies": {
+    "@microsoft/powerbi-modeling-mcp-linux-arm64": "0.5.0-beta.2",
+    "@microsoft/powerbi-modeling-mcp-win32-x64": "0.5.0-beta.2",
+    "@microsoft/powerbi-modeling-mcp-linux-x64": "0.5.0-beta.2",
+    "@microsoft/powerbi-modeling-mcp-win32-arm64": "0.5.0-beta.2",
+    "@microsoft/powerbi-modeling-mcp-darwin-arm64": "0.5.0-beta.2"
+  },
+  "mcpName": "powerbi-modeling-mcp"
+}