# microsoft/fabric-toolbox architecture

> Architecture diagram of the GitHub repository microsoft/fabric-toolbox, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/microsoft/fabric-toolbox
- Repository: https://github.com/microsoft/fabric-toolbox

## Overview

Fabric Toolbox is a collection of independent tools, accelerators, monitoring assets, and samples rather than one runtime. The graph emphasizes the documented Data Factory migration workflow, then shows other substantial product branches visible in the supplied tree and README. Sampled source supports some migration transformations, deployment calls, and MCP behavior; unsampled subsystem wiring is intentionally left out.

Main entry points: [`tools/FabricDataFactoryMigrationAssistant/src/App.tsx`](https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/App.tsx) (Migration wizard), [`accelerators/CICD/automate-wh-sqlendpoint-deployment/Program.cs`](https://github.com/microsoft/fabric-toolbox/blob/main/accelerators/CICD/automate-wh-sqlendpoint-deployment/Program.cs) (Warehouse deployment), [`tools/SemanticModelMCPServer/server.py`](https://github.com/microsoft/fabric-toolbox/blob/main/tools/SemanticModelMCPServer/server.py) (Semantic model MCP), [`tools/FabricDataFactoryMigrationAssistant/src/services/folderDeploymentService.ts`](https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/folderDeploymentService.ts) (Fabric deployment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_migration["ADF Migration"]
  node_wizard["Migration wizard<br/>[App.tsx]"]
  node_auth["Sign-in<br/>[authService.ts]"]
  node_upload["ADF parsing"]
  node_profiling["Project profiling"]
  node_mapping["Component mapping"]
  node_validation["Component validation"]
  node_connections["Connection mapping"]
  node_transform["Pipeline conversion"]
  node_deployment["Fabric deployment"]
  node_fabricapi["Fabric API<br/>[fabricApiClient.ts]"]
end

subgraph group_mirror["Lakehouse Mirror"]
  node_mirrorui["Mirror interface<br/>[App.tsx]"]
  node_mirrorapi["Mirror API routes<br/>[mirror.js]"]
  node_mirrorservice["Mirror execution<br/>[index.js]"]
end

subgraph group_mcp["MCP Tools"]
  node_mgmtserver["Fabric management MCP<br/>[server.py]"]
  node_pipeline_tool["Pipeline operations<br/>[pipeline_tools.py]"]
  node_semanticserver["Semantic model MCP<br/>[server.py]"]
  node_semantictools["Model analysis tools<br/>[bpa_tools.py]"]
  node_tokenmanager["Azure token cache"]
  node_daxserver["DAX tuner MCP<br/>[Program.cs]"]
  node_session[("Tuning session<br/>[SessionManager.cs]")]
end

subgraph group_deployment["Deployment Accelerators"]
  node_warehousebuild["Warehouse deployment<br/>[Program.cs]"]
  node_warehouseanalyze["Dependency analysis"]
  node_sqlproject["SQL project generation"]
end

subgraph group_monitoring["Monitoring"]
  node_platformmonitor["Platform monitoring"]
  node_sparkmonitor["Spark monitoring"]
  node_activityevents["Activity event monitoring"]
end

node_engineer(("Fabric engineer"))
node_fabric["Microsoft Fabric"]
node_lakehouse[("Fabric lakehouses")]
node_warehouse[("Fabric warehouse")]
node_fabricdata[("Fabric activity data")]

node_engineer -->|"uses"| node_wizard
node_wizard -->|"authenticates"| node_auth
node_wizard -->|"parses input"| node_upload
node_wizard -->|"profiles project"| node_profiling
node_wizard -->|"maps components"| node_mapping
node_wizard -->|"validates components"| node_validation
node_wizard -->|"applies mappings"| node_connections
node_wizard -->|"converts pipelines"| node_transform
node_wizard -->|"deploys artifacts"| node_deployment
node_deployment -->|"calls API"| node_fabricapi
node_fabricapi -->|"manages items"| node_fabric
node_mirrorui -->|"requests mirror"| node_mirrorapi
node_mirrorapi -->|"dispatches"| node_mirrorservice
node_mirrorservice -->|"mirrors data"| node_lakehouse
node_mgmtserver -->|"registers tools"| node_pipeline_tool
node_pipeline_tool -->|"manages pipelines"| node_fabric
node_semanticserver -->|"registers tools"| node_semantictools
node_semanticserver -->|"uses tokens"| node_tokenmanager
node_semantictools -->|"analyzes models"| node_fabric
node_daxserver -->|"tracks tuning"| node_session
node_warehousebuild -->|"analyzes dependencies"| node_warehouseanalyze
node_warehousebuild -->|"generates project"| node_sqlproject
node_warehousebuild -->|"deploys SQL"| node_warehouse
node_platformmonitor -->|"extracts inventory"| node_fabricdata
node_sparkmonitor -->|"analyzes Spark"| node_fabricdata
node_activityevents -->|"processes events"| node_fabricdata

click node_wizard "https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/App.tsx"
click node_auth "https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/authService.ts"
click node_upload "https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/adfParserService.ts"
click node_profiling "https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/folderAnalysisService.ts"
click node_mapping "https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/componentMappingService.ts"
click node_validation "https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/componentValidationService.ts"
click node_connections "https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/pipelineConnectionTransformerService.ts"
click node_transform "https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/pipelineTransformer.ts"
click node_deployment "https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/folderDeploymentService.ts"
click node_fabricapi "https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/fabricApiClient.ts"
click node_mirrorui "https://github.com/microsoft/fabric-toolbox/blob/main/accelerators/mirror-lakehouse/client/src/App.tsx"
click node_mirrorapi "https://github.com/microsoft/fabric-toolbox/blob/main/accelerators/mirror-lakehouse/server/routes/mirror.js"
click node_mirrorservice "https://github.com/microsoft/fabric-toolbox/blob/main/accelerators/mirror-lakehouse/server/index.js"
click node_mgmtserver "https://github.com/microsoft/fabric-toolbox/blob/main/tools/MicrosoftFabricMgmtMCPServer/server.py"
click node_pipeline_tool "https://github.com/microsoft/fabric-toolbox/blob/main/tools/MicrosoftFabricMgmtMCPServer/tools/pipeline_tools.py"
click node_semanticserver "https://github.com/microsoft/fabric-toolbox/blob/main/tools/SemanticModelMCPServer/server.py"
click node_semantictools "https://github.com/microsoft/fabric-toolbox/blob/main/tools/SemanticModelMCPServer/tools/bpa_tools.py"
click node_tokenmanager "https://github.com/microsoft/fabric-toolbox/blob/main/tools/SemanticModelMCPServer/core/azure_token_manager.py"
click node_daxserver "https://github.com/microsoft/fabric-toolbox/blob/main/tools/DAXPerformanceTunerMCPServer/src/DaxPerformanceTuner.Console/Program.cs"
click node_session "https://github.com/microsoft/fabric-toolbox/blob/main/tools/DAXPerformanceTunerMCPServer/src/DaxPerformanceTuner.Library/Core/SessionManager.cs"
click node_warehousebuild "https://github.com/microsoft/fabric-toolbox/blob/main/accelerators/CICD/automate-wh-sqlendpoint-deployment/Program.cs"
click node_warehouseanalyze "https://github.com/microsoft/fabric-toolbox/blob/main/accelerators/CICD/automate-wh-sqlendpoint-deployment/WarehouseDependencyAnalyzer.cs"
click node_sqlproject "https://github.com/microsoft/fabric-toolbox/blob/main/accelerators/CICD/automate-wh-sqlendpoint-deployment/SqlProjectBuilder.cs"
click node_platformmonitor "https://github.com/microsoft/fabric-toolbox/blob/main/monitoring/fabric-platform-monitoring/src/Inventory/Monitoring%20Extraction%20Scanner.Notebook/notebook-content.py"
click node_sparkmonitor "https://github.com/microsoft/fabric-toolbox/blob/main/monitoring/fabric-spark-monitoring/src/Spark%20Monitoring%20Recommedations.Notebook/notebook-content.py"
click node_activityevents "https://github.com/microsoft/fabric-toolbox/blob/main/monitoring/fabric-platform-monitoring/src/ActivityEvents/Monitoring%20Activity%20Events.Notebook/notebook-content.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_wizard,node_auth,node_upload,node_profiling,node_mapping,node_validation,node_connections,node_transform,node_deployment,node_fabricapi toneBlue
class node_mirrorui,node_mirrorapi,node_mirrorservice,node_lakehouse,node_warehouse,node_fabricdata toneAmber
class node_mgmtserver,node_pipeline_tool,node_semanticserver,node_semantictools,node_tokenmanager,node_daxserver,node_session toneMint
class node_warehousebuild,node_warehouseanalyze,node_sqlproject toneRose
class node_platformmonitor,node_sparkmonitor,node_activityevents,node_engineer,node_fabric toneIndigo
```

## Components

### ADF Migration

- [Migration wizard](https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/App.tsx): `tools/FabricDataFactoryMigrationAssistant/src/App.tsx`
- [Sign-in](https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/authService.ts): `tools/FabricDataFactoryMigrationAssistant/src/services/authService.ts`
- [ADF parsing](https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/adfParserService.ts): `tools/FabricDataFactoryMigrationAssistant/src/services/adfParserService.ts`
- [Project profiling](https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/folderAnalysisService.ts): `tools/FabricDataFactoryMigrationAssistant/src/services/folderAnalysisService.ts`
- [Component mapping](https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/componentMappingService.ts): `tools/FabricDataFactoryMigrationAssistant/src/services/componentMappingService.ts`
- [Component validation](https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/componentValidationService.ts): `tools/FabricDataFactoryMigrationAssistant/src/services/componentValidationService.ts`
- [Connection mapping](https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/pipelineConnectionTransformerService.ts): `tools/FabricDataFactoryMigrationAssistant/src/services/pipelineConnectionTransformerService.ts`
- [Pipeline conversion](https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/pipelineTransformer.ts): `tools/FabricDataFactoryMigrationAssistant/src/services/pipelineTransformer.ts`
- [Fabric deployment](https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/folderDeploymentService.ts): `tools/FabricDataFactoryMigrationAssistant/src/services/folderDeploymentService.ts`
- [Fabric API](https://github.com/microsoft/fabric-toolbox/blob/main/tools/FabricDataFactoryMigrationAssistant/src/services/fabricApiClient.ts): `tools/FabricDataFactoryMigrationAssistant/src/services/fabricApiClient.ts`

### Lakehouse Mirror

- [Mirror interface](https://github.com/microsoft/fabric-toolbox/blob/main/accelerators/mirror-lakehouse/client/src/App.tsx): `accelerators/mirror-lakehouse/client/src/App.tsx`
- [Mirror API routes](https://github.com/microsoft/fabric-toolbox/blob/main/accelerators/mirror-lakehouse/server/routes/mirror.js): `accelerators/mirror-lakehouse/server/routes/mirror.js`
- [Mirror execution](https://github.com/microsoft/fabric-toolbox/blob/main/accelerators/mirror-lakehouse/server/index.js): `accelerators/mirror-lakehouse/server/index.js`

### MCP Tools

- [Fabric management MCP](https://github.com/microsoft/fabric-toolbox/blob/main/tools/MicrosoftFabricMgmtMCPServer/server.py): `tools/MicrosoftFabricMgmtMCPServer/server.py`
- [Pipeline operations](https://github.com/microsoft/fabric-toolbox/blob/main/tools/MicrosoftFabricMgmtMCPServer/tools/pipeline_tools.py): `tools/MicrosoftFabricMgmtMCPServer/tools/pipeline_tools.py`
- [Semantic model MCP](https://github.com/microsoft/fabric-toolbox/blob/main/tools/SemanticModelMCPServer/server.py): `tools/SemanticModelMCPServer/server.py`
- [Model analysis tools](https://github.com/microsoft/fabric-toolbox/blob/main/tools/SemanticModelMCPServer/tools/bpa_tools.py): `tools/SemanticModelMCPServer/tools/bpa_tools.py`
- [Azure token cache](https://github.com/microsoft/fabric-toolbox/blob/main/tools/SemanticModelMCPServer/core/azure_token_manager.py): `tools/SemanticModelMCPServer/core/azure_token_manager.py`
- [DAX tuner MCP](https://github.com/microsoft/fabric-toolbox/blob/main/tools/DAXPerformanceTunerMCPServer/src/DaxPerformanceTuner.Console/Program.cs): `tools/DAXPerformanceTunerMCPServer/src/DaxPerformanceTuner.Console/Program.cs`
- [Tuning session](https://github.com/microsoft/fabric-toolbox/blob/main/tools/DAXPerformanceTunerMCPServer/src/DaxPerformanceTuner.Library/Core/SessionManager.cs): `tools/DAXPerformanceTunerMCPServer/src/DaxPerformanceTuner.Library/Core/SessionManager.cs`

### Deployment Accelerators

- [Warehouse deployment](https://github.com/microsoft/fabric-toolbox/blob/main/accelerators/CICD/automate-wh-sqlendpoint-deployment/Program.cs): `accelerators/CICD/automate-wh-sqlendpoint-deployment/Program.cs`
- [Dependency analysis](https://github.com/microsoft/fabric-toolbox/blob/main/accelerators/CICD/automate-wh-sqlendpoint-deployment/WarehouseDependencyAnalyzer.cs): `accelerators/CICD/automate-wh-sqlendpoint-deployment/WarehouseDependencyAnalyzer.cs`
- [SQL project generation](https://github.com/microsoft/fabric-toolbox/blob/main/accelerators/CICD/automate-wh-sqlendpoint-deployment/SqlProjectBuilder.cs): `accelerators/CICD/automate-wh-sqlendpoint-deployment/SqlProjectBuilder.cs`

### Monitoring

- [Platform monitoring](https://github.com/microsoft/fabric-toolbox/blob/main/monitoring/fabric-platform-monitoring/src/Inventory/Monitoring%20Extraction%20Scanner.Notebook/notebook-content.py): `monitoring/fabric-platform-monitoring/src/Inventory/Monitoring Extraction Scanner.Notebook/notebook-content.py`
- [Spark monitoring](https://github.com/microsoft/fabric-toolbox/blob/main/monitoring/fabric-spark-monitoring/src/Spark%20Monitoring%20Recommedations.Notebook/notebook-content.py): `monitoring/fabric-spark-monitoring/src/Spark Monitoring Recommedations.Notebook/notebook-content.py`
- [Activity event monitoring](https://github.com/microsoft/fabric-toolbox/blob/main/monitoring/fabric-platform-monitoring/src/ActivityEvents/Monitoring%20Activity%20Events.Notebook/notebook-content.py): `monitoring/fabric-platform-monitoring/src/ActivityEvents/Monitoring Activity Events.Notebook/notebook-content.py`

### Other components

- **Fabric engineer**
- **Microsoft Fabric**
- **Fabric lakehouses**
- **Fabric warehouse**
- **Fabric activity data**

## Connections

- Fabric engineer → Migration wizard: uses
- Migration wizard → Sign-in: authenticates
- Migration wizard → ADF parsing: parses input
- Migration wizard → Project profiling: profiles project
- Migration wizard → Component mapping: maps components
- Migration wizard → Component validation: validates components
- Migration wizard → Connection mapping: applies mappings
- Migration wizard → Pipeline conversion: converts pipelines
- Migration wizard → Fabric deployment: deploys artifacts
- Fabric deployment → Fabric API: calls API
- Fabric API → Microsoft Fabric: manages items
- Mirror interface → Mirror API routes: requests mirror
- Mirror API routes → Mirror execution: dispatches
- Mirror execution → Fabric lakehouses: mirrors data
- Fabric management MCP → Pipeline operations: registers tools
- Pipeline operations → Microsoft Fabric: manages pipelines
- Semantic model MCP → Model analysis tools: registers tools
- Semantic model MCP → Azure token cache: uses tokens
- Model analysis tools → Microsoft Fabric: analyzes models
- DAX tuner MCP → Tuning session: tracks tuning
- Warehouse deployment → Dependency analysis: analyzes dependencies
- Warehouse deployment → SQL project generation: generates project
- Warehouse deployment → Fabric warehouse: deploys SQL
- Platform monitoring → Fabric activity data: extracts inventory
- Spark monitoring → Fabric activity data: analyzes Spark
- Activity event monitoring → Fabric activity data: processes events