mbrummerstedt/powerbi-analyst-mcp

Аутентифицирует в Power BI с помощью OAuth 2.0 device code flow. Вызовите этот инструмент сначала, если вы никогда не входили в систему или если предыдущий вызов вернул "Not authenticated". Инструмент использует двухэтапный поток: - Первый вызов: возвращает URL и одноразовый код, который нужно открыть в браузере. - Второй вызов: завершает аутентификацию после того, как вы вошли в систему. Ваши учетные данные кэшируются локально, так что вам не придется повторять этот шаг до истечения срока действия токена обновления (примерно 90 дней).

Удаляет одну запись из журнала истории запросов. Используйте это, когда запрос дал неверные или вводящие в заблуждение результаты и не должен появляться в будущих поисках по истории. Связанный CSV-файл (если есть) НЕ удаляется. Удаляется только запись в журнале.

Выполняет DAX-запрос к датасету Power BI и возвращает строки результата. Запрос должен начинаться с EVALUATE (стандартный синтаксис DAX-запросов). Результаты возвращаются в виде JSON-массива объектов, где ключами являются имена столбцов. Небольшие результаты (<= 50 строк) возвращаются встроенным JSON. Большие результаты (> 50 строк) автоматически сохраняются в CSV-файл, а возвращается сжатая сводка с путём к файлу, именами столбцов, количеством строк и превью первых 5 строк. Используйте `read_query_result` для постраничного чтения сохранённого CSV или читайте файл напрямую. Каждый успешный вызов записывается в локальный файл истории для аудита и повторного использования между сессиями. Используйте `search_query_history` для поиска предыдущих запросов. Параметр `query_summary` делает поиск по истории гораздо эффективнее — всегда указывайте его, когда можете. Ограничения, накладываемые Power BI API: - Максимум 1 000 000 значений или 100 000 строк на запрос. - Ограничение по скорости: 120 запросов в минуту на пользователя. - Поддерживается только DAX; запросы MDX и DMV не поддерживаются. - Параметр клиента "Dataset Execute Queries REST API" должен быть включён. Советы: - Используйте TOPN или FILTER для ограничения больших наборов результатов. - Используйте SUMMARIZECOLUMNS для агрегированных запросов. - Используйте CALCULATETABLE для выражений с отфильтрованными таблицами. - Используйте max_rows для выборки большой таблицы без переписывания DAX. - Используйте result_name, чтобы задать осмысленное имя для сохранённого CSV.

Возвращает подробные метаданные для одного датасета Power BI. Включает имя, владельца, расписание обновления, режим хранения, веб-URL и многое другое. Также возвращает последние 5 записей истории обновлений, чтобы вы могли видеть свежесть данных.

Перечисляет столбцы (измерения) в наборе данных Power BI. Возвращает имя каждого столбца, родительскую таблицу, описание, тип данных и является ли он ключевым столбцом. Опционально фильтрует по имени таблицы.

Перечисляет все наборы данных (семантические модели) в рабочей области Power BI. Возвращает идентификатор набора данных, имя, кем настроен (configured-by), веб-URL, флаг is-refreshable и целевой режим хранения (Import / DirectQuery / и т.д.). Используйте поле `id` как `dataset_id` в последующих инструментах.

Перечисляет меры, определенные в наборе данных Power BI. Возвращает имя каждой меры, родительскую таблицу, описание и строку формата. Опционально фильтрует по имени таблицы.

Перечисляет все видимые таблицы в наборе данных Power BI. Скрытые таблицы и внутренние системные таблицы Power BI (имена, начинающиеся с '$') исключаются. Используйте возвращённые имена таблиц в `list_measures`, `list_columns` и DAX-запросах.

Перечисляет все рабочие области Power BI (группы), участником которых является аутентифицированный пользователь. Возвращает идентификатор рабочей области, имя, тип и сведения о ёмкости. Используйте поле `id` как `workspace_id` в последующих инструментах.

Выйдите из Power BI, очистив кэшированные учётные данные. После выхода вызовите `authenticate`, чтобы войти снова.

Читает страницу строк из CSV-файла, сохранённого `execute_dax`. Используйте этот инструмент, когда `execute_dax` возвращает путь `savedTo` вместо строк в ответе. Комбинируйте `offset` и `limit`, чтобы пролистывать большие результаты без загрузки всего файла в контекст. Возвращает строки для запрошенного среза вместе с метаданными пагинации: - totalRows: общее количество строк в файле - offset: использованный offset - limit: использованный limit - hasMore: есть ли ещё строки после этой страницы Пример рабочего процесса: 1. Вызовите `execute_dax` — если строк больше 50, вы получите путь savedTo. 2. Вызовите `read_query_result(file_path=savedTo, offset=0, limit=100)`. 3. Если hasMore равно true, вызовите снова с offset=100, затем 200 и т.д.

Ищет в локальном журнале истории запросов ранее выполненные DAX-запросы. Каждый успешный вызов `execute_dax` логируется с DAX-запросом, кратким описанием того, что запрашивал пользователь, формой результата и путём к любому сохранённому CSV-файлу. Используйте этот инструмент, чтобы: - Найти предыдущие запросы для набора данных, чтобы повторно использовать или адаптировать DAX - Найти сохранённые CSV-файлы из предыдущих сессий - Проверить, какие данные были извлечены и когда - Избежать повторного выполнения ресурсоёмких запросов, если данные уже существуют локально Результаты возвращаются от новых к старым. Используйте `keyword` для поиска по намерению (например, "revenue by market"): он ищет по описанию запроса, тексту DAX и имени результата.