Power BI Unified MCP

Eine MCP-Schnittstelle für KI-gesteuertes Power-BI-Semantikmodell-Engineering und PBIR/PBIP-Berichtserstellung.

Semantikmodell-Operationen werden über Microsofts Power BI Modeling MCP ausgeführt. Dieses Projekt fügt eine einheitliche Orchestrierung, lokale PBIR/PBIP-Berichtserstellung, Sicherheitskontrollen, Diagnose und stdio/HTTP-Transports hinter einem einzigen MCP-Server hinzu.

Status: Early Release / Public Preview - v0.2.0

Power BI ist ein Microsoft-Produkt. Dieses Repository gehört nicht zu Microsoft, es bündelt nicht Microsofts ausführbare Modellierungsdatei und ist kein vollständiger Ersatz für Power BI Desktop.

Warum es existiert

Die Power-BI-Automatisierung umfasst derzeit zwei verschiedene Ebenen:

• Semantikmodell-Engineering gegen Power BI Desktop oder kompatible tabellarische Modelle

• Bearbeitung von PBIR/PBIP-Berichtsdefinitionen auf der Festplatte

Dieses Projekt führt diese Ebenen zusammen, sodass ein KI-Client Berichte und Modelle über einen einzigen MCP-Toolkatalog prüfen, validieren und ändern kann, während lokale Sicherheitskontrollen weiterhin eingehalten werden.

Related MCP server: powerbi-mcp-local

Wie es sich von Microsofts Modeling MCP unterscheidet

Microsofts Modeling MCP konzentriert sich auf Semantikmodell-Operationen wie Verbindungen, Tabellen, Spalten, Measures, Beziehungen, DAX, Rollen, Partitionen, TMDL und verwandte Metadatenarbeit.

powerbi-unified-mcp behält diese Upstream-Fähigkeit bei, fügt aber Folgendes hinzu:

• lokale Erkennung und Lebenszyklus von PBIR/PBIP-Berichtsprojekten

• Seiten- und Visual-Erstellung

• Feldbindung und Formatierung

• Designs, Filter, Interaktionen, Validierung, Checkpoints und Rückgängig

• eine zusammengeführte MCP-Oberfläche für Berichts- und Modellarbeit

• lokale Richtliniendurchsetzung, Diagnose, Audit-Protokollierung und Fähigkeitsberichterstattung

Aktueller Umfang

Was v0.2.0 heute kann:

• PBIR/PBIP-Berichtsprojekte erkennen und öffnen

• Berichtsseiten erstellen, umbenennen, duplizieren und löschen

• unterstützte Visuals erstellen, prüfen, verschieben, skalieren, umtypisieren, binden und formatieren

• Designs anwenden, Filter setzen, visuelle Interaktionen konfigurieren und Berichtsstruktur validieren

• Berichts-Checkpoints erstellen, Checkpoints wiederherstellen und kürzliche Berichtsänderungen rückgängig machen

• Semantikmodell-Operationen von Microsofts Modeling MCP als Proxy weiterleiten

• lokale Power-BI-Desktop-Erkennung, Verbindung, DAX-Validierung/-Ausführung und temporäre Measure-CRUD über die Upstream-Toolfamilie unterstützen

• stdio- und HTTP-Transports mit dem offiziellen MCP SDK bereitstellen

Was es noch nicht kann:

• direkte Live-.pbix-Canvas-Mutation ohne PBIR/PBIP-Projekt

• vollständiges Power-BI-Service- oder Fabric-Lebenszyklusmanagement

• Lesezeichen-Mutation oder vollständige Button-/Navigationserstellung

• eine vollständige Abstraktion für bedingte Formatierung

• Unterstützung für jedes native oder benutzerdefinierte Power-BI-Visual

• gehostete Mehrbenutzer-Bereitstellung, Authentifizierung oder RBAC als fertiges Produkt

Architektur

flowchart TD
    A[AI Client / MCP Host] --> B[Power BI Unified MCP]

    B --> C[PBIR/PBIP Report Authoring Engine]
    B --> D[Microsoft Power BI Modeling MCP]

    C --> E[Pages]
    C --> F[Visuals]
    C --> G[Field Bindings]
    C --> H[Formatting]
    C --> I[Themes]
    C --> J[Filters & Interactions]
    C --> K[Validation & Checkpoints]

    D --> L[Power BI Desktop / Fabric Semantic Model]

    L --> M[Tables & Columns]
    L --> N[Measures & DAX]
    L --> O[Relationships]
    L --> P[Partitions]
    L --> Q[RLS / Security Roles]
    L --> R[Calculation Groups]
    L --> S[TMDL / TMSL]

Einfach ausgedrückt:

• Die Berichtserstellung ist in diesem Repository implementiert und arbeitet mit PBIR/PBIP-Projekten auf der Festplatte.

• Das Semantikmodell-Engineering wird an Microsofts externes Modeling MCP delegiert und anschließend mit Kompatibilitätsprüfungen, Richtliniendurchsetzung, Diagnose und Audit-Protokollierung umhüllt.

Weitere Details: Architektur

Schnellinstallation

git clone <repo-url>
cd powerbi-unified-mcp
npm install
npm run build
npm test

Wenn Microsoft Modeling MCP nicht automatisch erkannt wird:

$env:POWERBI_MODELING_MCP_EXE="C:\path\to\powerbi-modeling-mcp.exe"

Im stdio-Modus ausführen:

node server.js

Im HTTP-Modus ausführen:

node server.js --transport=http --port=8765

Health-Check:

curl http://127.0.0.1:8765/health

Vollständige Einrichtung: Installation

MCP-Client-Beispiele

• Allgemeine MCP-Clients

• Codex

• Claude

• ChatGPT

Beispiel-Prompts

Untersuche mein aktuell geöffnetes Power-BI-Desktop-Modell und fasse die Tabellen, Measures und Beziehungen zusammen.

Erstelle ein Total-Profit-Measure, validiere den DAX und frage ihn ab, um zu bestätigen, dass er funktioniert.

Öffne dieses PBIR-Berichtsprojekt und liste die Berichtsseiten, Visuals und das aktive Design auf.

Erstelle eine Berichtsseite „Executive Overview“ mit Total-Sales- und Profit-Karten, monatlichem Umsatztrend, Kategorie-Umsatz-Balkendiagramm und einem Region-Slicer.

Finde das Visual „Sales by Category“, ändere es in ein gruppiertes Balkendiagramm, verschiebe es auf die rechte Seite der Seite und validiere den Bericht.

Validiere den aktuellen PBIR-Bericht und erkläre alle Fehler, bevor du etwas änderst.

Sicherheit

Sicherheitsmodi:

• read-only

• safe-write

• full

Wichtige Standardeinstellungen:

• Berichtsänderungen sind auf konfigurierte Dateisystem-Stammverzeichnisse beschränkt

• die meisten Berichtsschreibvorgänge erstellen standardmäßig automatische Checkpoints

• destruktive oder sicherheitsrelevante Modellierungsoperationen sind richtliniengesteuert

• der HTTP-Modus ist ein Entwicklungs-Transport und sollte als lokal-first behandelt werden

Stellen Sie keinen full-Modus-Endpunkt ohne Authentifizierung, TLS, Reverse-Proxy, Protokollierung und Netzwerkschutz öffentlich bereit.

Weitere Details: Sicherheitsmodell

Kompatibilität

• Node.js >=20

• Windows ist die primär unterstützte Umgebung für die Live-Power-BI-Desktop-Integration

• Semantikmodell-Funktionen erfordern Microsofts Power BI Modeling MCP

• mindestens unterstützte Upstream-Modeling-MCP-Version: 0.4.0

• v0.2.0 wurde live gegen ein echtes Power-BI-Desktop-Modell getestet für Erkennung, Verbindung, Metadatenprüfung, DAX-Validierung/-Ausführung und temporäre Measure-CRUD mit Bereinigung

Weitere Details: Modeling-MCP-Kompatibilität

Einschränkungen

• direkte .pbix-Canvas-Bearbeitungen sind nicht der Weg zur Berichtserstellung; verwenden Sie PBIR/PBIP-Projekte

• Semantikmodell-Funktionen hängen von Microsofts Upstream-Ausführungsdatei ab

• die Live-Desktop-Integration ist auf Windows ausgerichtet

• die Berichts-Visual-Abdeckung ist umfangreich, aber nicht vollständig

Weitere Details: Einschränkungen

Dokumentation

• Dokumentations-Startseite

• Schnellstart

• Power BI Desktop

• Semantische Modellierung

• Berichtserstellung

• Visual-Katalog

• Konfigurationsreferenz

• Tools-Referenz

• Generierte Fähigkeitsmatrix

• Fehlerbehebung

• Roadmap

Mitwirken

Einrichtung für Mitwirkende, Testablauf, Metadatengenerierung und Release-Erwartungen: CONTRIBUTING.md

Lizenz

MIT. Siehe LICENSE.