Power BI Unified MCP

Единый MCP-интерфейс для управляемой ИИ инженерии семантических моделей Power BI и создания отчетов PBIR/PBIP.

Операции с семантическими моделями выполняются через Microsoft Power BI Modeling MCP. Этот проект добавляет единую оркестрацию, локальное создание отчетов PBIR/PBIP, механизмы контроля, диагностику и транспорты stdio/HTTP за одним MCP-сервером.

Статус: Early Release / Public Preview - v0.2.0

Power BI — продукт Microsoft. Этот репозиторий не принадлежит Microsoft, не включает исполняемый файл моделирования Microsoft и не является полной заменой Power BI Desktop.

Зачем это существует

Автоматизация Power BI сейчас охватывает два разных уровня:

• инженерия семантических моделей для Power BI Desktop или совместимых табличных моделей

• редактирование определений отчетов PBIR/PBIP на диске

Этот проект объединяет эти уровни, чтобы ИИ-клиент мог проверять, валидировать и изменять отчеты и модели через единый каталог инструментов MCP, сохраняя при этом локальные механизмы безопасности.

Related MCP server: powerbi-mcp-local

Чем это отличается от Modeling MCP от Microsoft

Modeling MCP от Microsoft фокусируется на операциях с семантическими моделями, таких как подключения, таблицы, столбцы, меры, связи, DAX, роли, разделы, TMDL и связанная работа с метаданными.

powerbi-unified-mcp сохраняет эту вышестоящую возможность, но добавляет:

• локальное обнаружение и жизненный цикл проектов отчетов PBIR/PBIP

• создание страниц и визуалов

• привязку полей и форматирование

• темы, фильтры, взаимодействия, валидацию, контрольные точки и отмену

• единую объединенную поверхность MCP для работы с отчетами и моделями

• локальное применение политик, диагностику, журналирование аудита и отчетность о возможностях

Текущий охват

Что v0.2.0 умеет сегодня:

• обнаруживать и открывать проекты отчетов PBIR/PBIP

• создавать, переименовывать, дублировать и удалять страницы отчетов

• создавать, проверять, перемещать, изменять размер, переопределять тип, привязывать и форматировать поддерживаемые визуалы

• применять темы, задавать фильтры, настраивать взаимодействия визуалов и валидировать структуру отчета

• создавать контрольные точки отчета, восстанавливать контрольные точки и отменять недавние изменения отчета

• проксировать операции с семантическими моделями из Microsoft Modeling MCP

• поддерживать локальное обнаружение Power BI Desktop, подключение, валидацию/выполнение DAX и CRUD временных мер через вышестоящее семейство инструментов

• предоставлять транспорты stdio и HTTP с использованием официального MCP SDK

Чего он пока не делает:

• прямого изменения холста .pbix в реальном времени без проекта PBIR/PBIP

• полного управления жизненным циклом 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 и выполни запрос, чтобы убедиться, что она работает.

Открой этот проект отчета PBIR и перечисли страницы отчета, визуалы и активную тему.

Создай страницу отчета Executive Overview с карточками Total Sales и Profit, трендом месячных продаж, столбчатой диаграммой продаж по категориям и срезом Region.

Найди визуал Sales by Category, измени его на кластерную столбчатую диаграмму, перемести в правую часть страницы и проверь отчет.

Проверь текущий отчет PBIR и объясни любые ошибки перед внесением изменений.

Безопасность

Режимы безопасности:

• read-only

• safe-write

• full

Важные значения по умолчанию:

• изменения отчета ограничены настроенными корнями файловой системы

• большинство записей отчета по умолчанию создают автоматические контрольные точки

• разрушительные или чувствительные к безопасности операции моделирования ограничены политикой

• режим HTTP — это транспорт для разработки, и его следует рассматривать как локальный в первую очередь

Не выставляйте конечную точку режима full публично без аутентификации, TLS, обратного проксирования, журналирования и сетевых защит.

Подробнее: Модель безопасности

Совместимость

• Node.js >=20

• Windows — основная поддерживаемая среда для живой интеграции Power BI Desktop

• функции семантических моделей требуют 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.