# sanketagnihotrishorthillsai/fabricmcp_server architecture

> Architecture diagram of the GitHub repository sanketagnihotrishorthillsai/fabricmcp_server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sanketagnihotrishorthillsai/fabricmcp_server
- Repository: https://github.com/sanketagnihotrishorthillsai/fabricmcp_server

## Overview

##### Project type and purpose
- This is a backend API server (“FabricMCP Server”) written in Python.
- Its purpose is to expose Microsoft Fabric operations (“tools”) over an MCP (Multi‐Cover Protocol) interface so that an LLM can invoke Fabric functions (create lakehouses, pipelines, notebooks, etc.) programmatically.

##### File structure
- Top‐level:
- .env.example / .gitignore / pyproject.toml / uv.lock – environment, packaging, lock files
- README.md – project overview & setup
- src/fabricmcp_server:
- app.py – ASGI entrypoint (FastAPI or similar)
- fabric_api_client.py – wraps calls to Microsoft Fabric REST APIs
- sessions.py – manages HTTP sessions, authentication (service principal)
- common_schemas.py, copy_activity_schemas.py, activity_types.py – Pydantic schemas and enums defining data models
- fabric_models.py – domain models mapping Fabric entities
- tools/ – one module per Fabric “tool” (lakehouses.py, notebooks.py, pipelines.py, items.py, datasets.py, connections.py, connection_manager.py, universal_copy_activity.py, configure_copy_activity.py)

##### README for additional insights
- Uses Python 3.10+, Uvicorn CLI (`uv venv`, `uv pip install`, etc.) as ASGI server
- Exposes Fabric functionality through an MCP client interface
- No built‐in persistent store – the Fabric service is the primary external dependency

a. Main components
- LLM/MCP Client – issues natural‐language‐driven MCP calls
- FabricMCP Server – ASGI application (FastAPI)
– API Layer (app.py, route definitions)
– Tool Layer (modules under tools/, each implementing a Fabric operation)
– Schema Layer (Pydantic models + enums)
– Fabric API Client (sessions.py + fabric_api_client.py)
- Microsoft Fabric Service (external REST API)

b. Relationships and interactions
1. LLM/MCP Client → HTTP/gRPC call → FabricMCP Server (app.py)
2. Server routes invoke appropriate tool module
3. Tool modules validate input against Pydantic schemas, then call Fabric API Client
4. Fabric API Client opens an authenticated session → Microsoft Fabric REST API
5. Response flows back through the same path

c. Architectural patterns & design principles
- Layered architecture (API → tools → client → external)
- Plugin‐style “tool” modules for each Fabric domain
- Dependency injection via FastAPI for sessions & config
- Use of Pydantic for schema validation
- Externalization of secrets/config in .env

d. Key technologies & libraries
- Python 3.10+
- FastAPI (or similar ASGI framework) + Uvicorn (“uv” CLI)
- Pydantic for schemas
- Requests or HTTPX for REST calls (sessions.py)
- Microsoft Fabric REST API
- MCP protocol / client integration

##### Diagramming recommendations
– Rectangles for in‐process components (API, tools, client modules)
- With protocols/tech: “HTTP/JSON over MCP”, “HTTPX + OAuth2/SPN session”, “Pydantic validation”

## Diagram (Mermaid)

```mermaid
graph TD
    client["LLM/MCP Client"]:::client

    subgraph "API Layer"
        api["FastAPI app (app.py)"]:::api
    end

    subgraph "Business-Logic Tool Layer"
        lakehouses["lakehouses.py: Lakehouse Tool"]:::tool
        notebooks["notebooks.py: Notebook Tool"]:::tool
        pipelines["pipelines.py: Pipeline Tool"]:::tool
        items["items.py: Item Tool"]:::tool
        datasets["datasets.py: Dataset Tool"]:::tool
        connections["connections.py: Connection Tool"]:::tool
        connection_manager["connection_manager.py: Connection Manager Tool"]:::tool
        universal_copy["universal_copy_activity.py: Universal Copy Activity Tool"]:::tool
        configure_copy["configure_copy_activity.py: Configure Copy Activity Tool"]:::tool
    end

    subgraph "Schema Layer"
        common_schemas["common_schemas.py"]:::schema
        copy_activity_schemas["copy_activity_schemas.py"]:::schema
        activity_types["activity_types.py"]:::schema
    end

    subgraph "Integration Layer"
        fabric_client["fabric_api_client.py"]:::integration
        sessions["sessions.py"]:::integration
    end

    domain_models["fabric_models.py"]:::domain

    external["Microsoft Fabric Service"]:::external

    subgraph "Configuration & Packaging"
        env_example[".env.example"]:::config
        pyproject["pyproject.toml"]:::config
        uvlock["uv.lock"]:::config
        readme["README.md"]:::config
        gitignore[".gitignore"]:::config
        init["__init__.py"]:::config
    end

    client -->|HTTP/gRPC call| api
    api -->|invokes| lakehouses
    api -->|invokes| notebooks
    api -->|invokes| pipelines
    api -->|invokes| items
    api -->|invokes| datasets
    api -->|invokes| connections
    api -->|invokes| connection_manager
    api -->|invokes| universal_copy
    api -->|invokes| configure_copy

    lakehouses -->|validate via| common_schemas
    notebooks -->|validate via| common_schemas
    pipelines -->|validate via| common_schemas
    items -->|validate via| common_schemas
    datasets -->|validate via| common_schemas
    connections -->|validate via| common_schemas
    connection_manager -->|validate via| common_schemas
    universal_copy -->|validate via| copy_activity_schemas
    configure_copy -->|validate via| copy_activity_schemas
    lakehouses -->|use enum| activity_types
    notebooks -->|use enum| activity_types
    pipelines -->|use enum| activity_types

    lakehouses -->|calls| fabric_client
    notebooks -->|calls| fabric_client
    pipelines -->|calls| fabric_client
    items -->|calls| fabric_client
    datasets -->|calls| fabric_client
    connections -->|calls| fabric_client
    connection_manager -->|calls| fabric_client
    universal_copy -->|calls| fabric_client
    configure_copy -->|calls| fabric_client

    fabric_client -->|uses| sessions
    sessions -->|auth from| env_example

    fabric_client -->|REST API calls| external
    external -->|responses| fabric_client

    fabric_client -->|maps to domain| domain_models

    classDef client fill:#DFF8FF,stroke:#0094C6,color:#000
    classDef api fill:#FFEFD5,stroke:#FF8C00,color:#000
    classDef tool fill:#E6E6FA,stroke:#9370DB,color:#000
    classDef schema fill:#FFFACD,stroke:#DAA520,color:#000
    classDef integration fill:#F0FFF0,stroke:#32CD32,color:#000
    classDef domain fill:#F5F5F5,stroke:#A9A9A9,color:#000
    classDef external fill:#FFE4E1,stroke:#DC143C,color:#000
    classDef config fill:#F5FFFA,stroke:#20B2AA,color:#000

    click api "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/src/fabricmcp_server/app.py"
    click lakehouses "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/src/fabricmcp_server/tools/lakehouses.py"
    click notebooks "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/src/fabricmcp_server/tools/notebooks.py"
    click pipelines "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/src/fabricmcp_server/tools/pipelines.py"
    click items "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/src/fabricmcp_server/tools/items.py"
    click datasets "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/src/fabricmcp_server/tools/datasets.py"
    click connections "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/src/fabricmcp_server/tools/connections.py"
    click connection_manager "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/src/fabricmcp_server/tools/connection_manager.py"
    click universal_copy "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/src/fabricmcp_server/tools/universal_copy_activity.py"
    click configure_copy "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/src/fabricmcp_server/tools/configure_copy_activity.py"
    click common_schemas "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/src/fabricmcp_server/common_schemas.py"
    click copy_activity_schemas "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/src/fabricmcp_server/copy_activity_schemas.py"
    click activity_types "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/src/fabricmcp_server/activity_types.py"
    click fabric_client "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/src/fabricmcp_server/fabric_api_client.py"
    click sessions "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/src/fabricmcp_server/sessions.py"
    click domain_models "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/src/fabricmcp_server/fabric_models.py"
    click env_example "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/.env.example"
    click pyproject "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/pyproject.toml"
    click uvlock "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/uv.lock"
    click readme "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/README.md"
    click gitignore "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/.gitignore"
    click init "https://github.com/sanketagnihotrishorthillsai/fabricmcp_server/blob/main/src/fabricmcp_server/__init__.py"
```
