Power BI Modeling MCP SSE ブリッジ

このプロジェクトは、公式Microsoft Power BI Modeling MCPサーバーのための高性能な SSE (Server-Sent Events) ブリッジ です。ローカルの stdio パイプを必要とせず、あらゆる言語（Laravel、Python、Goなど）からURLベースでPower BIセマンティックモデルとシームレスに対話できます。

🔥 主な革新機能

• 自動認証 (トークン注入): 管理者資格情報を使用してAzure ROPCフローを自動的に実行し、アクセストークンを注入します。結果: サーバー上でブラウザのポップアップが一切発生しません。

• 動的バイナリ解決: OSとCPUアーキテクチャを自動検出し、適切なMicrosoft MCPバイナリを起動します。

• Laravelコンテキスト注入: URLクエリパラメータを介してワークスペースIDとデータセットIDを渡し、セッション固有のコンテキストを維持します。

• Web対応: Power BI用のカスタムAIチャットインターフェースを構築するのに最適です。

Related MCP server: powerbi-mcp-proxy

🛠️ インストールとクイックスタート

1. 要件

• Node.js v18以上。

• Power BI管理者アカウント（マスターユーザー）またはサービスプリンシパル。

2. セットアップ

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

3. 設定

テンプレートから .env ファイルを作成します：

cp .env.example .env

MS_PBI_... 資格情報を入力します。重要: ブラウザなしでパスワードベースのログインを機能させるには、Azureアプリ登録の「認証」設定で 「パブリッククライアントフローを許可する」 を有効にしてください。

4. 実行

npm start

ブリッジは http://localhost:3000/sse で起動します。

🔗 Laravel統合の例

Laravelの Http ファサードを使用してブリッジと対話する例：

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権限チェックリスト

• [ ] Azureポータル: Tenant.Read.All を持つアプリ登録が存在すること。

• [ ] Power BI管理者: 「サービスプリンシパルによるPower BI APIの使用を許可する」が ON になっていること。

• [ ] ワークスペース: アプリまたはユーザーが メンバー/共同作成者 として追加されていること。

🤝 クレジット

このブリッジは、コアエンジンとして Microsoft Power BI Modeling MCP Server を使用しています。プロトコル実装を提供してくれたMicrosoftチームに感謝します。

📄 ライセンス

MITライセンス。自由にご利用・ご貢献ください！