Power BI Unified MCP

AI駆動のPower BIセマンティックモデル設計とPBIR/PBIPレポート作成のための単一MCPインターフェース。

セマンティックモデル操作は、MicrosoftのPower BI Modeling MCPを介して実行されます。このプロジェクトは、統合オーケストレーション、ローカルでのPBIR/PBIPレポート作成、安全対策、診断、およびstdio/HTTPトランスポートを単一のMCPサーバーの背後に追加します。

状態: 公開初期版 / パブリックプレビュー - v0.2.0

Power BIはMicrosoftの製品です。このリポジトリはMicrosoft所有ではなく、Microsoftのモデリング実行ファイルをバンドルしておらず、Power BI Desktopの完全な代替品でもありません。

存在理由

Power BIの自動化は現在、次の2つの異なるレイヤーに分かれています。

• Power BI Desktopまたは互換性のある表形式モデルに対するセマンティックモデル設計

• ディスク上のPBIR/PBIPレポート定義の編集

このプロジェクトは、これらのレイヤーをまとめて、AIクライアントがローカルの安全制御を尊重しつつ、1つのMCPツールカタログでレポートとモデルを検査、検証、変更できるようにします。

Related MCP server: powerbi-mcp-local

MicrosoftのModeling MCPとの違い

MicrosoftのModeling MCPは、接続、テーブル、列、メジャー、リレーションシップ、DAX、役割、パーティション、TMDL、および関連するメタデータ作業などのセマンティックモデル操作に焦点を当てています。

powerbi-unified-mcp はその上流機能を維持しつつ、以下を追加します。

• ローカルPBIR/PBIPレポートプロジェクトの検出とライフサイクル

• ページとビジュアルの作成

• フィールドのバインドと書式設定

• テーマ、フィルター、相互作用、検証、チェックポイント、アンドウ

• レポートとモデル作業のための単一統合MCPサーフェス

• ローカルポリシーの適用、診断、監査ログ、機能レポート

現在のスコープ

v0.2.0 が現在できることは次のとおりです。

• PBIR/PBIPレポートプロジェクトの検出と台努

• レポートページの作成、名前変更、変更、削除

• 対応したビジュアルの作成、検査、移動、サイズ変更、種別変更、バインド、書式

• テーマの適用、フィルターの設定、ビジュアルの相互作用の構成、レポート構造の検証

• レポート要件ポイントの作成、ポイントの復元、最近のレポート変更のアンドウ

• MicrosoftのModeling MCPからのセマンティックモデル操作のプロキシ

• ローカルPower BI Desktopの検出、接続、DAXの検証/実行、一時メジャーのCRUDを上流のツールフジを通じてサポート

• 公式MCP SDKを使用した、stdioおよびHTTPトランスポートの提供

まだできないこと:

• PBIR/PBIPプロジェクトではない、直接ライブの .pbix キャンバスの変更

• Power BI ServiceまたはFabricの完全なライフサイクル管理

• ブックマークの変更、ボタンやナビゲーションの完全な作成

• 条件付き書式の完全な抽象化

• すべての標準ビジュアルまたはカスタムPower BIビジュアルのサポート

• ホスト型のマルチユーザー導入、認証、RBACを完成製品として提供

アーキテクチャ

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]

平易な説明:

• レポートの作成はこのリポジトリに実装され、ディスク上のPBIR/PBIPプロジェクトで動作します。

• セマンティックモデル設計はMicrosoftの外部Modeling MCPに委譲され、その後に互換伯性チェック、ポリシーの適用、診断、の監査ログが追加されています。

詳細: アーキテクチャ

クイックインストール

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

Microsoft Modeling MCPが自動で検出されない場合:

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

stdioモードで実行する:

node server.js

HTTPモードで実行する:

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

ヘルスチェック:

curl http://127.0.0.1:8765/health

完全なセットアップ: インストールガイド

MCPクライアントの例

• 汎用MCPクライアント

• Codex

• Claude

• ChatGPT

プロンプトの例

現在開いているPower BI Desktopモデルを検査して、テーブル、メジャー、関係をまとめてください。

Total Profitメジャーを作成し、DAXを検証して、動作することを確認してください。

このPLIRプロジェクトを開いて、レポートページ、ビジュアル、適用中テーマを一覧表示してください。

Executive Overviewというレポートページを、Total SalesとProfitのカード、月別販売動向、カテゴリ別売上棒ベインが表示、Regionスライサーを追加してページしてください。

Sales by Categoryビジュアルを検索し、クラスタード棒ベイングラフに変更して、ページの右側に移動し、レポートを検証してください。

現在の該当条件を決定し、何かを変更する前にエラーを説明してください。

セキュリティ

セキュリティモード:

• retrieve-only

• safe-write

• full

重要なデフォルト:

• レポートの変更は、設定されたファイルシステムルートに制限されます。

• レポートの変更では、通常、自動チェックポイントがデフォルトで作成されます。

• 破壊的または安全水対プロセスの高いモデリング操作は、ポリシーによって制限されます。

• HTTPモードは開発用の転送であるため、ローカル優先で扱う必要があります。

認証、TLS、リバースプロキシ、ロギング、ネットワーク保護をしないで、full モードのエンドポイントをパブリックに公開しないでください。

詳細: セキュリティモデル

互換性

• Node.js >=20

• 保存されているWindowsDesktopとの連携は、Windowsが主なサポート形式です。

• セマンティックモデル機能には、MicrosoftのPower BI Modeling MCPが必要

• サポートされる上流のModeling MCPバージョン: 0.4.0

• v0.2.0 は、実際のPower BI Desktopモデルで、検出、接続、メタデータ検査、DAX検証/実行、一時メジャーCRUDとクリーニングを含むテスト済みです。

詳細: Modeling MCP 互換性

制限事項

• .pbix キャンバスの直接編集はレポート作成のパスではありません。PBIR/PBIPプロジェクトを使用してください。

• セマンティックモデル機能は、Microsoft社の機能実行ファイルに依存します。

• ライブのDesktop統合は、Windowsが中心です。

• レポートビジュアルの対応範囲は広範ですが、まだ完全ではありません。

詳細: 制限事項

ドキュメント

• ドキュメントホーム

• クイックスタート

• Power BI Desktop

• セマンティックモデリング

• レポート作成

• ビジュアルカタログ

• 設定リファレンス

• ツールリファレンス

• 生成された機能マトリクス

• トラブルシューティング

• ロードマップ

コントリビューション

コントリビューターのセットアップ、テスト手順、メタデータ生成、およびリリースの期待値については、CONTRIBUTING.md を参照してください。

ライセンス

MIT。 LICENSE