Power BI Modeling MCP SSE Bridge

Этот проект представляет собой высокопроизводительный SSE (Server-Sent Events) мост для официального MCP-сервера Microsoft Power BI Modeling. Он обеспечивает беспрепятственное взаимодействие с семантическими моделями Power BI на основе URL из любого языка (Laravel, Python, Go) без необходимости использования локального stdio-канала.

🔥 Ключевые инновации

• Автоматическая аутентификация (внедрение токенов): Автоматически выполняет поток Azure ROPC с использованием ваших учетных данных администратора для внедрения токена доступа. Результат: никаких всплывающих окон браузера на вашем сервере.

• Динамическое разрешение бинарных файлов: Автоматически определяет вашу ОС и архитектуру процессора для запуска правильного бинарного файла Microsoft MCP.

• Внедрение контекста Laravel: Передавайте идентификаторы рабочих областей (Workspace) и наборов данных (Dataset) через параметры запроса URL для поддержания контекстов, специфичных для сессии.

• Готовность к вебу: Идеально подходит для создания пользовательских интерфейсов ИИ-чатов для Power BI.

Related MCP server: powerbi-mcp-proxy

🛠️ Установка и быстрый старт

1. Требования

• Node.js версии 18 или выше.

• Учетная запись администратора Power BI (Master User) или Service Principal.

2. Настройка

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

3. Конфигурация

Создайте файл .env на основе шаблона:

cp .env.example .env

Заполните свои учетные данные MS_PBI_.... Важно: Чтобы вход по паролю работал без браузера, включите "Allow public client flows" в настройках Azure App Registration -> Authentication.

4. Запуск

npm start

Мост будет доступен по адресу http://localhost:3000/sse.

🔗 Пример интеграции с Laravel

Использование фасада Http в Laravel для взаимодействия с мостом:

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: Параметр "Allow service principals to use Power BI APIs" ВКЛЮЧЕН.

• [ ] Рабочая область: Приложение или пользователь добавлены в качестве участника/автора (Member/Contributor).

🤝 Благодарности

Этот мост использует Microsoft Power BI Modeling MCP Server в качестве основного движка. Особая благодарность команде Microsoft за реализацию протокола.

📄 Лицензия

Лицензия MIT. Не стесняйтесь использовать и вносить свой вклад!