tompo-mcp 0.1.0__tar.gz

tompo_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TOMPo Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tompo_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,177 @@
+Metadata-Version: 2.4
+Name: tompo-mcp
+Version: 0.1.0
+Summary: TOMPo — Power BI & Fabric Lineage Intelligence MCP Server. Trace lineage from semantic models to reports to visuals. Impact analysis for every column and measure.
+Project-URL: Homepage, https://github.com/microsoft/tompo-mcp
+Project-URL: Repository, https://github.com/microsoft/tompo-mcp
+Author-email: Tushar Pardeshi <tpardeshi@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: copilot,fabric,impact-analysis,lineage,mcp,powerbi,semantic-model
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: azure-identity>=1.15.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Description-Content-Type: text/markdown
+
+# TOMPo MCP — Power BI & Fabric Lineage Intelligence
+
+**Trace lineage from semantic models → tables → reports → pages → visuals → columns/measures.**
+
+An MCP (Model Context Protocol) server that brings Power BI lineage intelligence directly into your AI assistant — GitHub Copilot, Claude Desktop, Cursor, or any MCP-compatible client.
+
+## What it does
+
+- **Full Lineage:** See exactly which columns and measures appear in which visuals, across all reports bound to a semantic model
+- **Impact Analysis:** "What breaks if I rename `Employee.StartDate`?" — instantly shows every affected visual
+- **Interactive Visualization:** Export a self-contained D3 tree (HTML file) with expand/collapse, zoom, and search
+- **Zero Infrastructure:** Runs locally on your machine using your own Azure identity. No App Service, no Docker, no backend.
+
+## Quick Start
+
+### 1. Install
+
+```bash
+pip install git+https://github.com/microsoft/tompo-mcp.git
+```
+
+Or clone and install locally:
+
+```bash
+git clone https://github.com/microsoft/tompo-mcp.git
+cd tompo-mcp
+pip install -e .
+```
+
+### 2. Login to Azure
+
+```bash
+az login
+```
+
+### 3. Add to VS Code
+
+Add to your VS Code `settings.json` (Ctrl+Shift+P → "Preferences: Open User Settings (JSON)"):
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "tompo": {
+        "command": "python",
+        "args": ["-m", "tompo_mcp"]
+      }
+    }
+  }
+}
+```
+
+### 4. Use in Copilot Chat
+
+Open GitHub Copilot Chat and start asking:
+
+```
+> List my Fabric workspaces
+> Generate lineage for dataset abc-123 in workspace xyz-456
+> What visuals use the Employee.Department column?
+> Export the lineage as an interactive HTML file
+```
+
+## MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_workspaces` | List all Fabric/Power BI workspaces you have access to |
+| `generate_lineage` | Full lineage: Model → Tables → Reports → Pages → Visuals → Fields |
+| `impact_analysis` | Find all visuals where a specific column or measure is used |
+| `describe_semantic_model` | Detailed metadata: tables, columns, measures, relationships, roles |
+| `export_lineage_html` | Generate interactive D3 visualization as a self-contained HTML file |
+
+## How It Works
+
+```
+You type in Copilot Chat
+        │
+        ▼
+Copilot calls TOMPo MCP tools
+        │
+        ▼
+TOMPo runs locally on your machine:
+  → Uses your az login identity
+  → Calls Fabric REST APIs (getDefinition, Scanner, DAX)
+  → Parses model + report definitions
+  → Builds lineage tree
+  → Returns data to Copilot
+        │
+        ▼
+Copilot shows the lineage tree / impact table
+(or opens interactive HTML in your browser)
+```
+
+### Authentication
+
+TOMPo uses `DefaultAzureCredential` which automatically picks up:
+1. **Azure CLI** (`az login`) — most common for developers
+2. **VS Code Azure Account** — if you're signed into the Azure extension
+3. **Environment variables** — for CI/CD pipelines
+4. **Managed Identity** — for Azure-hosted scenarios
+
+You need access to the Fabric workspaces you want to analyze. No extra app registrations or service principals required.
+
+### Metadata Extraction (3-tier fallback)
+
+1. **Fabric `getDefinition` API** — returns full model.bim / TMDL / PBIR definitions
+2. **Admin Scanner API** — fallback if getDefinition fails (requires admin permissions)
+3. **DAX `executeQueries`** — last resort using `INFO.TABLES()`, `INFO.COLUMNS()`, etc.
+
+If a sensitivity label blocks access, TOMPo temporarily downgrades to "General", extracts metadata, then restores the original label.
+
+## Interactive Visualization
+
+The `export_lineage_html` tool generates a single HTML file with:
+- **D3 horizontal tree** with expand/collapse nodes
+- **Color-coded** by type (model, table, report, page, visual, column, measure)
+- **Impact Analysis tab** with searchable data grid
+- **Semantic Model tab** with tables, columns, measures, relationships
+- **Zoom, pan, fullscreen** — all interactive
+- **Works offline** — all JavaScript and CSS inlined, no server needed
+
+## Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "tompo": {
+      "command": "python",
+      "args": ["-m", "tompo_mcp"]
+    }
+  }
+}
+```
+
+## Development
+
+```bash
+git clone https://github.com/microsoft/tompo-mcp.git
+cd tompo-mcp
+pip install -e ".[dev]"
+python -m pytest tests/
+```
+
+## Requirements
+
+- Python 3.10+
+- Azure CLI (`az login`) or any Azure credential
+- Access to Fabric/Power BI workspaces
+
+## License
+
+MIT

tompo_mcp-0.1.0/README.md

@@ -0,0 +1,155 @@
+# TOMPo MCP — Power BI & Fabric Lineage Intelligence
+
+**Trace lineage from semantic models → tables → reports → pages → visuals → columns/measures.**
+
+An MCP (Model Context Protocol) server that brings Power BI lineage intelligence directly into your AI assistant — GitHub Copilot, Claude Desktop, Cursor, or any MCP-compatible client.
+
+## What it does
+
+- **Full Lineage:** See exactly which columns and measures appear in which visuals, across all reports bound to a semantic model
+- **Impact Analysis:** "What breaks if I rename `Employee.StartDate`?" — instantly shows every affected visual
+- **Interactive Visualization:** Export a self-contained D3 tree (HTML file) with expand/collapse, zoom, and search
+- **Zero Infrastructure:** Runs locally on your machine using your own Azure identity. No App Service, no Docker, no backend.
+
+## Quick Start
+
+### 1. Install
+
+```bash
+pip install git+https://github.com/microsoft/tompo-mcp.git
+```
+
+Or clone and install locally:
+
+```bash
+git clone https://github.com/microsoft/tompo-mcp.git
+cd tompo-mcp
+pip install -e .
+```
+
+### 2. Login to Azure
+
+```bash
+az login
+```
+
+### 3. Add to VS Code
+
+Add to your VS Code `settings.json` (Ctrl+Shift+P → "Preferences: Open User Settings (JSON)"):
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "tompo": {
+        "command": "python",
+        "args": ["-m", "tompo_mcp"]
+      }
+    }
+  }
+}
+```
+
+### 4. Use in Copilot Chat
+
+Open GitHub Copilot Chat and start asking:
+
+```
+> List my Fabric workspaces
+> Generate lineage for dataset abc-123 in workspace xyz-456
+> What visuals use the Employee.Department column?
+> Export the lineage as an interactive HTML file
+```
+
+## MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_workspaces` | List all Fabric/Power BI workspaces you have access to |
+| `generate_lineage` | Full lineage: Model → Tables → Reports → Pages → Visuals → Fields |
+| `impact_analysis` | Find all visuals where a specific column or measure is used |
+| `describe_semantic_model` | Detailed metadata: tables, columns, measures, relationships, roles |
+| `export_lineage_html` | Generate interactive D3 visualization as a self-contained HTML file |
+
+## How It Works
+
+```
+You type in Copilot Chat
+        │
+        ▼
+Copilot calls TOMPo MCP tools
+        │
+        ▼
+TOMPo runs locally on your machine:
+  → Uses your az login identity
+  → Calls Fabric REST APIs (getDefinition, Scanner, DAX)
+  → Parses model + report definitions
+  → Builds lineage tree
+  → Returns data to Copilot
+        │
+        ▼
+Copilot shows the lineage tree / impact table
+(or opens interactive HTML in your browser)
+```
+
+### Authentication
+
+TOMPo uses `DefaultAzureCredential` which automatically picks up:
+1. **Azure CLI** (`az login`) — most common for developers
+2. **VS Code Azure Account** — if you're signed into the Azure extension
+3. **Environment variables** — for CI/CD pipelines
+4. **Managed Identity** — for Azure-hosted scenarios
+
+You need access to the Fabric workspaces you want to analyze. No extra app registrations or service principals required.
+
+### Metadata Extraction (3-tier fallback)
+
+1. **Fabric `getDefinition` API** — returns full model.bim / TMDL / PBIR definitions
+2. **Admin Scanner API** — fallback if getDefinition fails (requires admin permissions)
+3. **DAX `executeQueries`** — last resort using `INFO.TABLES()`, `INFO.COLUMNS()`, etc.
+
+If a sensitivity label blocks access, TOMPo temporarily downgrades to "General", extracts metadata, then restores the original label.
+
+## Interactive Visualization
+
+The `export_lineage_html` tool generates a single HTML file with:
+- **D3 horizontal tree** with expand/collapse nodes
+- **Color-coded** by type (model, table, report, page, visual, column, measure)
+- **Impact Analysis tab** with searchable data grid
+- **Semantic Model tab** with tables, columns, measures, relationships
+- **Zoom, pan, fullscreen** — all interactive
+- **Works offline** — all JavaScript and CSS inlined, no server needed
+
+## Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "tompo": {
+      "command": "python",
+      "args": ["-m", "tompo_mcp"]
+    }
+  }
+}
+```
+
+## Development
+
+```bash
+git clone https://github.com/microsoft/tompo-mcp.git
+cd tompo-mcp
+pip install -e ".[dev]"
+python -m pytest tests/
+```
+
+## Requirements
+
+- Python 3.10+
+- Azure CLI (`az login`) or any Azure credential
+- Access to Fabric/Power BI workspaces
+
+## License
+
+MIT

tompo_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "tompo-mcp"
+version = "0.1.0"
+description = "TOMPo — Power BI & Fabric Lineage Intelligence MCP Server. Trace lineage from semantic models to reports to visuals. Impact analysis for every column and measure."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "Tushar Pardeshi", email = "tpardeshi@gmail.com" }]
+keywords = ["powerbi", "fabric", "lineage", "mcp", "copilot", "impact-analysis", "semantic-model"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = [
+    "mcp>=1.0.0",
+    "httpx>=0.27.0",
+    "azure-identity>=1.15.0",
+    "pydantic>=2.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/microsoft/tompo-mcp"
+Repository = "https://github.com/microsoft/tompo-mcp"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tompo_mcp"]

tompo_mcp-0.1.0/src/tompo_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""TOMPo MCP — Power BI & Fabric Lineage Intelligence."""
+
+__version__ = "0.1.0"

tompo_mcp-0.1.0/src/tompo_mcp/__main__.py

@@ -0,0 +1,5 @@
+"""Entry point: python -m tompo_mcp"""
+
+from tompo_mcp.server import run_server
+
+run_server()

tompo_mcp-0.1.0/src/tompo_mcp/auth.py

@@ -0,0 +1,59 @@
+"""
+Authentication for TOMPo MCP.
+
+Uses DefaultAzureCredential (Azure CLI / VS Code) by default.
+Also accepts a raw bearer token for Fabric Notebook scenarios.
+"""
+
+from __future__ import annotations
+
+import logging
+from typing import Optional
+
+from azure.identity import DefaultAzureCredential
+
+logger = logging.getLogger(__name__)
+
+_credential: Optional[DefaultAzureCredential] = None
+
+
+def _get_credential() -> DefaultAzureCredential:
+    global _credential
+    if _credential is None:
+        _credential = DefaultAzureCredential(
+            exclude_shared_token_cache_credential=True,
+        )
+        logger.info("DefaultAzureCredential initialized")
+    return _credential
+
+
+class TokenProvider:
+    """Provides bearer tokens for Fabric/Power BI API calls.
+
+    If initialized with a raw token string, uses it directly (Fabric Notebook).
+    Otherwise uses DefaultAzureCredential (az login / VS Code identity).
+    """
+
+    def __init__(self, token: Optional[str] = None) -> None:
+        self._raw_token = token
+
+    def get_powerbi_token(self) -> str:
+        if self._raw_token:
+            return self._raw_token
+        cred = _get_credential()
+        result = cred.get_token("https://analysis.windows.net/powerbi/api/.default")
+        return result.token
+
+    def get_fabric_token(self) -> str:
+        if self._raw_token:
+            return self._raw_token
+        cred = _get_credential()
+        result = cred.get_token("https://api.fabric.microsoft.com/.default")
+        return result.token
+
+    def get_graph_token(self) -> str:
+        if self._raw_token:
+            return self._raw_token
+        cred = _get_credential()
+        result = cred.get_token("https://graph.microsoft.com/.default")
+        return result.token