powerbi-report-mcp

# powerbi-report-mcp An [MCP](https://modelcontextprotocol.io) server for reading and editing the **report/visual layer of Power BI PBIP projects** — pages, visuals, field bindings, formatting, and themes — directly on disk, so AI assistants can build and restyle reports alongside you. It pairs with Microsoft's official [powerbi-modeling-mcp](https://www.npmjs.com/package/@microsoft/powerbi-modeling-mcp) (semantic model: tables, measures, relationships); this server deliberately never touches the semantic model. ## Features - **37 tools** covering connections, pages, visuals, field wells, format patching, themes, report settings, and style profiles. - **Implicit active report** — `connection_name` is optional on every tool; the most recently opened/used report is the default target. - **Git-style undo** — every edit is snapshotted per connection; `undo()` rolls back one step at a time (no redo), and `list_history()` shows the undo stack. - **Atomic writes** — files are written via temp-file rename so Power BI Desktop never sees a half-written JSON file. - **Schema-validated models** — Pydantic models mirror Microsoft's published PBIP JSON schemas, with a discriminated union per visual family. - **Style profiles** — capture fonts, colours, borders, and canvas size in a reusable JSON profile and distil it into a report, page, or single visual with `apply_style`; only the parts relevant to the scope are applied. - **Extension visual types** — register custom/AppSource visuals at runtime with the `register_visual_extension` tool; usable immediately, no restart. - **stdio and HTTP transports** — spawned per client (stdio, default) or one instance serving many clients via `--transport http`, with each client in its own isolated session. ## Quick start Requires [uv](https://docs.astral.sh/uv/) (Python 3.12+ is fetched automatically). Two officially supported ways to run it: **Usage — PyPI, stdio** (recommended for normal use): ```json { "po…