Power BI Modeling MCP SSE Bridge

Dieses Projekt ist eine leistungsstarke SSE (Server-Sent Events) Bridge für den offiziellen Microsoft Power BI Modeling MCP-Server. Sie ermöglicht eine nahtlose, URL-basierte Interaktion mit Power BI-Semantikmodellen aus jeder Sprache (Laravel, Python, Go) heraus, ohne dass lokales stdio-Piping erforderlich ist.

🔥 Wichtige Innovationen

• Auto-Auth (Token-Injektion): Führt automatisch einen Azure ROPC-Flow unter Verwendung Ihrer Admin-Anmeldedaten durch, um ein Zugriffstoken einzufügen. Ergebnis: Keine Browser-Popups auf Ihrem Server.

• Dynamische Binärauflösung: Erkennt automatisch Ihr Betriebssystem und Ihre CPU-Architektur, um die korrekte Microsoft MCP-Binärdatei zu starten.

• Laravel-Kontextinjektion: Übergeben Sie Workspace- und Dataset-IDs über URL-Abfrageparameter, um sitzungsspezifische Kontexte beizubehalten.

• Web-Ready: Perfekt für den Aufbau benutzerdefinierter KI-Chat-Schnittstellen für Power BI.

Related MCP server: powerbi-mcp-proxy

🛠️ Installation & Schnellstart

1. Anforderungen

• Node.js v18 oder höher.

• Power BI-Administratorkonto (Master-Benutzer) oder Service Principal.

2. Einrichtung

git clone https://github.com/nusagates/mcp_pbi.git
cd mcp_pbi
npm install

3. Konfiguration

Erstellen Sie eine .env-Datei aus der Vorlage:

cp .env.example .env

Füllen Sie Ihre MS_PBI_...-Anmeldedaten aus. Wichtig: Damit die passwortbasierte Anmeldung ohne Browser funktioniert, aktivieren Sie "Allow public client flows" in Ihren Azure App-Registrierungs-Einstellungen unter Authentifizierung.

4. Ausführen

npm start

Die Bridge ist unter http://localhost:3000/sse verfügbar.

🔗 Laravel-Integrationsbeispiel

Verwendung der Http-Fassade von Laravel zur Interaktion mit der Bridge:

use Illuminate\Support\Facades\Http;

// 1. Establish connection context (via Browser/SSE Client)
// URL: http://localhost:3000/sse?workspace_id=abc&dataset_id=123

// 2. Execute a Tool through the bridge
$response = Http::post("http://localhost:3000/messages?sessionId=YOUR_SESSION_ID", [
    "jsonrpc" => "2.0",
    "id" => 1,
    "method" => "tools/call",
    "params" => [
        "name" => "execute_dax_query",
        "arguments" => [
            "query" => "EVALUATE TOPN(10, 'YourTable')"
        ]
    ]
]);

return $response->json();

🛡️ Power BI-Berechtigungs-Checkliste

• [ ] Azure Portal: App-Registrierung existiert mit Tenant.Read.All.

• [ ] Power BI Admin: "Allow service principals to use Power BI APIs" ist AN.

• [ ] Arbeitsbereich: App oder Benutzer wurde als Mitglied/Mitwirkender hinzugefügt.

🤝 Credits

Diese Bridge verwendet den Microsoft Power BI Modeling MCP-Server als Kern-Engine. Besonderer Dank geht an das Microsoft-Team für die Protokollimplementierung.

📄 Lizenz

MIT-Lizenz. Fühlen Sie sich frei, sie zu nutzen und dazu beizutragen!