pbi-cli
CLI и 13 скиллов для Claude Code: модель данных Power BI, меры DAX, безопасность на уровне строк и страницы отчета PBIR прямо из чата
- 476 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Команды создают, меняют и удаляют таблицы, меры, роли безопасности и страницы отчета в вашей модели
- Утилита выполняет запросы DAX и подключается к данным открытой модели Power BI Desktop
- Скилл пользовательских визуалов запускает npm и собирает проект TypeScript на вашей машине
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/pbi-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Команды создают, меняют и удаляют таблицы, меры, роли безопасности и страницы отчета в вашей модели
- Утилита выполняет запросы DAX и подключается к данным открытой модели Power BI Desktop
- Скилл пользовательских визуалов запускает npm и собирает проект TypeScript на вашей машине
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
pbi-cli — консольная утилита для Power BI, рассчитанная на ИИ-агентов, и набор из 13 скиллов для Claude Code. Она работает в двух слоях. Слой семантической модели подключается к открытому Power BI Desktop напрямую через .NET (TOM и ADOMD) без отдельного MCP-сервера: агент создает таблицы, связи, меры и иерархии, выполняет и проверяет запросы DAX, правит роли безопасности и перспективы, выгружает и сравнивает снимки модели в TMDL. Слой отчета читает и пишет файлы PBIR (расширенный формат отчета) без подключения к Power BI Desktop, поэтому работает с проектами `.pbip`. Через него агент создает отчет, страницы и закладки, добавляет и привязывает визуалы (поддерживаются 32 типа), ставит фильтры TopN, по дате и по категории, применяет темы и условное форматирование. Отдельный скилл создает собственные визуалы на TypeScript и упаковывает их в `.pbiviz`. Для скриптов и агентов у команд есть режим `--json`. Команды объединены в 27 групп: запросы, модель, развертывание, безопасность, диагностика (трассировка, статистика модели), страницы, фильтры, форматирование и закладки.
Для кого. Для аналитиков и BI-разработчиков на Windows, которые строят модели и отчеты Power BI и хотят доверить рутину Claude Code.
Подходит, если
- Нужно создать десятки мер или перенести их массово: агент делает это одной операцией вместо ручного ввода
- Мера DAX возвращает ошибку или неверные числа, и ее надо отладить
- Перед крупными правками требуется снимок модели в TMDL и возможность откатиться
- Роли безопасности на уровне строк надо создать и проверить для региональных менеджеров
- Отчет с нуля: страницы, визуалы, фильтры и тема собираются запросами в чате
Не подходит, если
- Вы работаете на macOS или Linux: слой модели требует Windows и запущенного Power BI Desktop
- Нужен MCP-сервер для подключения по протоколу: у Microsoft есть собственный сервер авторинга моделей Power BI
- Нужна визуальная правка вручную мышью: утилита рассчитана на команды и файлы PBIR
- Модель живет только в сервисе Power BI без Desktop и проекта `.pbip`: слою отчета нужны файлы PBIR
Пример запроса к агенту
Создай звездообразную схему с таблицами Sales и Calendar и добавь меры выручки и маржиОграничения
Нужны Windows, Python 3.10 или новее и запущенный Power BI Desktop с открытым файлом `.pbix` для слоя модели. Утилита ставится через pipx или pip, а после этого требуется команда `pbi-cli skills install`, которая регистрирует скиллы в Claude Code. При установке через pip команда `pbi` часто оказывается вне PATH, и в README советуют pipx или добавление каталога Scripts в PATH. Слой отчета работает только с форматом PBIR и проектами `.pbip`. Скилл пользовательских визуалов при первом запуске по согласию ставит Node.js и `pbiviz` и использует фиксированную версию SDK, а любые пакеты npm вне допустимого списка требуют отдельного подтверждения.
Как отключить. Выполните `pbi-cli skills uninstall`, чтобы убрать скиллы из Claude Code, затем `pipx uninstall pbi-cli-tool`. Конфигурация лежит в `~/.pbi-cli/`.
Частые вопросы
Как поставить pbi-cli для Claude Code?
Выполните три команды: `pipx install pbi-cli-tool`, затем `pbi-cli skills install` (регистрирует скиллы в Claude Code) и `pbi connect`, чтобы подключиться к Power BI Desktop. Можно просто дать Claude ссылку на репозиторий, и он сам склонирует, установит и подключится.
Нужен ли MCP-сервер?
Нет. Слой модели работает через прямой вызов .NET из Python к Power BI Desktop (TOM и ADOMD), без MCP-сервера и внешних бинарников, и выполняет команды меньше чем за секунду. Слой отчета читает и пишет файлы PBIR напрямую.
Какие скиллы ставятся?
Тринадцать. Для модели: DAX, моделирование, развертывание, безопасность, документация, партиции и диагностика. Для отчета: отчет, визуалы, страницы, темы, фильтры и пользовательские визуалы. Первые семь работают после `pbi connect`, остальные без подключения.
Как откатить неудачные правки модели?
Перед изменениями сохраните снимок командой `database export-tmdl`, а потом вернитесь через `database import-tmdl`. Для сравнения двух снимков есть `database diff-tmdl`, а группа `transaction` собирает правки в одну транзакцию.
Можно ли проверить безопасность на уровне строк?
Да. Скилл безопасности создает роли, фильтры и перспективы (группа `security-role` и команда `perspective`), а в README есть пример проверки правил для региональных менеджеров.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMarketplace плагинов для Claude Code и GitHub Copilot по Power BI и Microsoft Fabric: семантические модели, DAX, TMDL, отчеты
Локальный MCP-сервер Microsoft для семантических моделей Power BI: агент создает таблицы, меры DAX и связи в Power BI Desktop, Fabric и файлах PBIP
Скилл визуализации данных для агентов: превращает данные в аккуратные интерактивные HTML-графики и целые отчеты с единым визуальным языком
MCP-сервер и CLI для управления настоящим Microsoft Excel: Power Query, DAX, VBA, сводные таблицы, диаграммы
Набор Databricks Field Engineering для агентов: установщик скиллов Databricks, MCP-сервер и визуальный Builder App
Легкое рабочее место для баз данных с MCP-сервером: агент читает схему, выполняет запросы и разбирает данные в PostgreSQL, MySQL и других
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| pbi-cli (эта запись) | нет | 476 | ||
| Power BI Authoring MCP Server | да | OAuth | 1 244 | официальный локальный MCP-сервер Microsoft для моделей Power BI, без слоя отчета и скиллов |
| power-bi-agentic-development | нет | 1 065 | маркетплейс плагинов для Power BI и Fabric для Claude Code и Copilot, а здесь одна утилита со своим набором скиллов |
Коротко о README
README открывается лозунгом «дайте Claude Code навыки Power BI» и кратким началом работы из трех команд с требованиями. Дальше показаны два слоя, примеры запросов для модели (массовое создание мер, отладка DAX, снимки и откат, аудит модели, проверка безопасности) и для отчета (шесть шагов сборки, 32 типа визуалов), схема архитектуры и автосинхронизация с Desktop. Затем идут таблицы 13 скиллов, раздел о пользовательских визуалах и справочник из 27 групп команд.