Pbix Atlas

io.github.fabienfrfrPublished by GitHub account fabienfrfrv1.0.0Updated Oct 24, 2026

Bidirectional data lineage graph for Power BI (.pbix) files, from source to display

The publisher's own server: Red Atlas Api

VerifiedSTDIODesktop onlyDeveloper ToolsData & Analytics

Overview

AI-generated overview

Builds a traversable data lineage graph for Power BI .pbix files, tracing sources through Power Query and DAX to report visuals.

What you can do
PbixAtlas parses a Power BI .pbix file and constructs a bidirectional lineage graph linking physical sources (HTTP, OData, SQL, files), Power Query (M) steps, columns, calculated columns, DAX measures, and the fields shown in report visuals. It exposes search, upstream and downstream traversal, tree printing, and export to GraphML or node/edge CSV. It can also generate a standalone Python pipeline reproducing a report's chain from source to a Vizro dashboard, executing the M source with a built-in interpreter.
When to use it
Useful when you need to understand or document where a Power BI report's numbers come from, trace impact of a source or measure change, or hand a report's logic to a Python pipeline. It fits analysts and engineers auditing Power BI models rather than general-purpose BI querying.
Requirements
Runs locally as a Python package (pip install pbix-atlas or uv add pbix-atlas); the HTTP/MCP server is started with uv run pbix-atlas and binds to PBIX_LINEAGE_HOST and PBIX_LINEAGE_PORT. Codegen needs the codegen extra. Desktop only; no authentication is declared.
Before you install
The server reads .pbix files, which may contain embedded credentials or connection strings in their data sources; the generated lineage graph and exports can therefore expose source endpoints and model details. The codegen feature executes M source at runtime through a built-in interpreter, so treat generated pipelines as code to review before running.

Installation

In SourceWeft

  1. Open Pbix Atlas in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

🌐 PBIX‑Atlas

[PyPI] [GitHub] [CI] [MCP Registry]

Full lineage graph for Power BI — from source to visual field

PbixAtlas is an Universal lineage graph for Power BI .pbix files: source to visual field in one traversable graph.

source (HTTP, OData, SQL, file...) --> Power Query (M)    --> column / calculated column --> measure (DAX)        --> field displayed in a report visual

Install

bash
pip install pbix-atlas# oruv add pbix-atlas

Quick start

python
from pbix_atlas import LineageGraphBuilder, upstream, downstream, print_tree, find_nodes
graph = LineageGraphBuilder().build("my_report.pbix")
find_nodes(graph, "customer_name")print_tree(graph, "visual_field::my_report.pbix::Page1::16::customer_name", direction="upstream")print_tree(graph, "source::odata::example.com/odata/", direction="downstream")

Export

python
from pbix_atlas import export_graphml, export_nodes_csv, export_edges_csv, graph_summary
graph_summary(graph)  # {'query': 70, 'column': 183, ...}export_graphml(graph, "lineage.graphml")  # Gephi / yEdexport_nodes_csv(graph, "nodes.csv")export_edges_csv(graph, "edges.csv")

Codegen — standalone Python pipeline

Generates a single Python file reproducing a report's full chain: source → extraction → Power Query → semantic model → Vizro dashboard. The M source is executed at runtime by the built-in interpreter, not pattern-matched. Unimplemented functions raise MRuntimeError (no silent stubs).

bash
pip install "pbix-atlas[codegen]"pbix-atlas-codegen my_report.pbix -o pipeline.py
python
from pbix_atlas import generate_python_pipeline
generate_python_pipeline("my_report.pbix", "pipeline.py")

HTTP API / MCP server

bash
uv sync --extra apiuv run pbix-atlas    # http://127.0.0.1:8080
  • REST: POST /graphs, /search, /upstream, /downstream, /tree, /export, /codegen
  • MCP (streamable HTTP): http://127.0.0.1:8080/mcp/
  • Env vars: PBIX_LINEAGE_HOST, PBIX_LINEAGE_PORT

Architecture

ModuleResponsibility
models.pyNode/edge types and shared data structures
sources.pyPhysical source detection (configurable patterns)
pbix_model.pyAdapter isolating from pbixray
m_lexer.py / m_parser.pyBuilt-in M tokenizer and parser
m_interpreter.pyM runtime interpreter + stdlib
dax_translate.pyDAX → Python (supported subset)
dax.pyDAX reference parsing
mquery.pyPower Query dependencies (table-level)
layout.pyInternal Report/Layout format parsing
graph_builder.pyOrchestrator: builds the networkx.DiGraph
navigation.pyUpstream/downstream traversal, search, export
codegen.pyPython pipeline code generation
api/app.pyFastAPI + MCP mount (FastMCP)

Sample files

Development

bash
uv sync --extra devuv run pytestuv build

Source: README.md at commit 3b489b6

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Atlas integrations

Red Atlas Api

red.atlasOfficial publisher

Remote MCP server giving an assistant access to Puerto Rico and Colombia real estate data: listings, sales, parcels, permits, analytics and AVM reports.

Streamable HTTPWeb executableAuth
Business & CommerceCredential requiredOct 24, 2026

Election Atlas

Published by GitHub account TaltonFiggins

A remote atlas of US and Canadian election geographies that lets an assistant look up places, districts, boundaries and officials.

Streamable HTTPWeb executable
Data & Analytics11 toolsNov 7, 2026

Boundary Atlas

Published by GitHub account TaltonFiggins

Remote MCP server for US and Canadian boundaries: look up cities, ZIPs, counties, districts and precincts, locate points, and fetch GeoJSON.

Streamable HTTPWeb executable
Data & Analytics11 toolsNov 7, 2026

Atlas Primer Voice Roleplay

Published by GitHub account AtlasPrimer

Atlas Primer Voice Roleplay's hosted MCP server; no sign-in required; Streamable HTTP; 1 tool.

Streamable HTTPWeb executable
1 toolNov 3, 2026

Smart Rings Atlas

Published by GitHub account thiazzz

Remote MCP server for researching smart rings: search dated records, compare evidence, estimate subscription costs and find regional buying links.

Streamable HTTPWeb executable
Business & Commerce4 toolsOct 29, 2026